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PREFACE 


The System Productivity Facility (SPF) is a program product that 
assists in program development. It is designed to take advantage 
of the characteristics of IBM 3270 display terminals, and to 
increase programmer productivity in an interactive environment. 


The System Productivity Facility replaces the previous Structured 
Programming Facility program products (SPF/TSO and SPF/CMS). It 
includes significant new functions that support the development, 
testing, and execution of interactive applications. 


SPF consists of two major components: the dialog manager and the 
program development facility. The dialog manager provides con- 
trol and services for running interactive applications. The pro- 
gram development facility provides the previous SPF functions. 


This manual contains detailed information on how to use the SPF 
program development facility under VM/CMS. It is intended for use 
by an application or systems programmer, engaged in program 
development, who is familiar with the VM environment. 


The first three chapters of this manual contain: 


Summary of Amendments - A summary of changes and enhancements 
to the SPF program development facility. 


Introduction - A brief description of the purpose of the SPF 
program development facility. 


General Description ~- A description of features that are com~- 
mon across the various processing options. 


The next several chapters provide detailed user information for 
each function, as follows: 


Invocation and Termination Foreground COption 4) 
Member List Commands Batch COption 5) 

SPF Parms (Option 0) Command COption 6) 
Browse (Option 1) Support COption 7) 
Edit COption 23 Tutorial COption T) 


Utilities (Option 3) 


This manual also includes several appendixes containing a sample 
problem, description of listing formats, command and quick refer- 
ence summaries, and differences in SPF usage in the MVS and VM 
environments. 


SPF COMMAND FORMATS 


In this document, the following notation conventions are used to 
describe SPF command formats: 


° Command verbs and keywords, which must be typed exactly as 
shown, are represented with uppercase characters. 


° Substitutable operands are represented with lowercase charac~- 
ters. > 


e Optional parameters are enclosed in brackets, "[" and "]". 
e A choice ef paronetars is indicated with slashes. 

° Default parameters are underscored. 

Example: = CAPS CON/OFF] 


The operand is optional. Either ON or OFF may be typed. If the 
operand is omitted, ON is the default. 
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RELATED DOCUMENTS 


iv 


SPE Dialog Management Services (SC34-2036) - Provides a 
detailed description of the new SPF services and related 
information required to develop an interactive application 


that runs under SPF. Applies to both the MVS/TSO and VM/CMS 


environments. 


SPF-VM General Information (6034-2046) - Provides an overview 
and functional description of SPF in the VM7CMS environment. 


SPE-MVS General Information (G6C34-2039) - Provides an over- 
view To functional description of SPF in the MVS/TSO envi- 
ronment. 


SPF-MVS_ Program Reference (SC34-2038) - Provides detailed 
information on how to use the SPF program development facili- 
ty in the MVS/TSO environment. . 
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SUMMARY OF AMENDMENTS 


Most of the changes and new capability in SPF are in the dialog 
manager. The program development facility is the same as the pre- 
vious SPF products, except for the following: 


e Support for IBM 3278 Model 5. Terminals. Ona Model 5, infor- 
mation is normally displayed in "“default™ mode (24 lines by 80 
columns) with the same size characters as other models. — 
Browse and edit data that is wider than 80 characters is dis- 
played with the smaller "native™ mode characters Cup to 132 
per line). Transition between the two modes is handled auto- 
matically. However, the user can force SPF to remain in one 
mode or the other via option 0.1. 


e New Command Name. SPF is now invoked with the "ISPF™ command. 
This allows concurrent use of the new and previous SPF pro- 
ducts during the transition period. Your installation may 
assign "SPF" as an alias of "ISPF" if desired. 


® Initial Option on ISPF Command. An initial option (e.g., "2" 
or "3.1") may be specified as a parameter on the "ISPF"™ com- 
mand to bypass initial display of the primary option menu. 


° Input Field Padding. Nulls are now used as the default pad- 
ding for menu input fields and command lines to enable use of 
the INSERT key. The user may change the pad character to 
blanks via option 0.1. 


° Scroll Amount Field. The current scroll amount 1s now a 
“remembered” parameter (during sessions and across sessions). 
Three different scroll amounts are saved -- one for browse, 
one for edit, and one for member lists. 


° Edit NUMBER and RENUM Commands. These commands now allow an 
additional DISPLAY parameter to specify whether sequence num- 
bers Cin the data) are to be displayed. 


e Transmission of SPF Libraries. The spool and reader utili- 
ties Coptions 3.6 and 3.7) now support transmission of an 
entire SPF library Cincluding statistics) to another CMS user 
on the same or different VM system. 


° Support for PASCAL/VS Compiler. The new PASCAL/VS compiler 
is supported under foreground and batch Coptions 4 and 5). 


© New Option 7. A new primary option, option 7, provides sup- 

port for testing of interactive applications designed to run 
under the SPF dialog manager, and for converting menus”) and 
messages to the new SPF formats. The tutorial, which was pre- 
viously option 7, 1s now option T. 


° Program Function (PF) Key Usage. The following changes have 
been made in PF key usage: 


= The default assignment for PF4 is RETURN. This” only 
affects new users. The remembered PF assignments in cur- 
rent user profiles are carried forward. 


= Under tutorial, the Scroll Down PF key is interpreted to 
mean "skip to next topic.” Previously, it had no function 
in tutorial mode. 


Finally, there has been a terminology change to more closely 
reflect general usage. Previously, all SPF screen images were 
called menus. The term menu is now used to mean a display from 
which the user may select options. The term panel is used to mean 
any predefined display image, of which one type is a menu. Other 
types include data entry panels and information Ce.g.>, 
help/tutorial) displays. 
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INTRODUCTION 


The SPF program development facility is designed to increase pro- 
grammer productivity in an interactive environment. It can be 
used either by an individual programmer, or by many programmers 
working together on a project. Significant features include: 


® Support for multilevel programming libraries. Facilitates 
maintenance and tracking of program segments at varying ver- 
sion and modification levels. 


° Full-screen, context editing. Allows additions and changes 
to multiple lines in a single interaction. Simple 
one-character edit commands are used for inserting, deleting, 
duplicating, or rearranging lines of source data. 


e Forward, backward, and sideways scrolling of source data or 
listings, plus the ability to locate information by character 
string or line number. 


° Utilities for specification and maintenance of SPF libraries 
and files. 

° Interface to standard language processors (compilers and 
etal iets for execution in the foreground or CMS batch 
machine. 


® Document preparation support. Includes text editing features 
and an interface to the SCRIPT/VS Document Composition Facil- 
ity. 


° Online tutorial for instruction and reference -- especially 
valuable for the occasional or novice user. 


The program development facility supports both structured and 
conventional programming techniques. 


Structured programming emphasizes the use of segmentation and 
indentation. A source program normally consists of a large number 
of relatively small segments. The segments are stored as separate 
members of a programming library. Within a segment, source state- 
ments are block-indented under each “"IF-THEN-ELSE™ or "DO-WHILE"™ 
to show the control structure. Features which are specifically 
oriented toward structured programming include: 


° Ease of segmentation changes. One segment Cmember) can easi-~ 
ly be split into multiple segments, or multiple segments can 
be merged into one. 


e Ease of indentation changes. Single statements or blocks of 
statements can easily be shifted left or right by a specified 
number of column positions. 


° Insert in context. A "DO-END" pair, for example, may be coded 
on consecutive lines, and then space can be opened between the 
two lines to allow insertion of a block of code. 


° Visual verification aids. A block of code may be temporarily 
excluded from display so that the space which it occupies on 
the screen is closed up. This facilitates visual verifica~ 
tion of the control structure, particularly when the length 
of a segment exceeds the screen size. 
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GENERAL DESCRIPTION 


DISPLAY 


Following is a description of features that are common across the 
various processing options of the program development facility. 


FORMAT 


Four basic types of display presentations are used: 


1. Selection Menus ~- The user selects from a list of options by 
typing a one-character code and pressing the ENTER key. Exam- 
ple: The SPF primary option menu (Figure 1). 


2. Entry Panels - The user supplies parameters by filling in 
labeled fields. In many cases, fields are pre-entered based 
on what the user last entered. Example: The browse entry 
panel (Figure 2). 


3. Member Selection Lists - Displays a list of members in a pro- 
gramming library. The user may select a member by entering a 
one~character code in front of the appropriate member name. 
Figure 3 shows an example of a member list on which the user 
has selected member COINS. 


4. Data Display - Displays source code or output listings. 
Figure 4 shows an example of the browse display. 


All menus and panels are formatted to fit on a 24 line by 80 char- 
acter screen. On a 3278 Model 3 or 4, scrollable data will occupy 
the full length of the screen (32 or 43 lines). 


On a 3278 Model 5, information is normally displayed in "default" 
mode (24 by 80) with the same size characters as other models. 
Browse and edit data that is wider than 80 characters is displayed 
with the smaller "native™ mode characters Cup to 132 per line). 
The user may override the automatic switching of modes. 


The first three lines of each display are formatted as follows: 






line 2 Prompt/Input 


The title area Cline 1) identifies the function being performed 
and, where appropriate, the library or file identification, 
member name, version number, and modification level. The short 
message area (line 1) is used to indicate: 


° Current line (browse) and column positions. (browse and edit) 
e Successful completion of a processing function 
e Error conditions Caccompanied by audible alarm) 


The prompt/input area (Cline 2) is used to enter an option 
selection or command... In cases where no option selection or com- 
mand is applicable, this area contains a prompt. The scroll area 
Cline 2) contains the current scroll amount whenever scrolling is 
applicable. The scroll amount may be overtyped by the user (see 
"Scrolling™). 


The long message area (line 3) is used to display an explanation 
of error conditions upon request (see “Help Information"). 
Normally this line is blank on menus and panels, contains column 
headings on member selection lists, and is treated as part of the 
data area on data displays. 
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SELECT OPTION === | 

USERID STEPHENS 
SPF PARMS - SPECIFY TERMINAL AND SPF PARAMETERS TIME 12:47 
BROWSE DISPLAY SOURCE DATA OR OUTPUT LISTINGS TERMINAL - 3277 
EDIT CREATE OR CHANGE SOURCE DATA PF KEYS - 12 
UTILITIES - PERFORM SPF UTILITY FUNCTIONS 
FOREGROUND - COMPILE, ASSEMBLE, LOAD, OR TEST 
BATCH COMPILE, ASSEMBLE, OR LOAD 
COMMAND = - ENTER CMS COMMAND OR EXEC | 
SUPFORT = = TEST DIALOG OR CONVERT MENU/MESSAGE FORMATS — 
TUTORIAL = DISPLAY INFORMATION ABOUT SPF | 
EXIT ~ TERMINATE SPF USING CONSOLE, LOG, AND LIST DEFAULTS 


0 
1 
2 
3 
4 
5 
6 
7 
T 
x 


PRESS END KEY TO TERMINATE SPF 





Figure 1. Primary Option Menu 


BROWSE ~- ENTRY PANEL 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY 
PROJECT 
LIBRARY 
TYPE 
MENBER 


SPFDEMO 
MYLIB 
PLI 


HH WY 
Hou ue it 


vvvyv 


(BLANK FOR MEMBER SELECTION LIST) 


CMS FILE: 
FILE ID ===> 
NEMBER ===> (FOR MACLIB OR TXTLIB) 
IF NOT LINKED, SPECIFY: 
ONNER'S ID === DEVICE ADDR. === LINK ACCESS MODE ===> 


READ PASSWORD ===> 





Figure 2. Browse - Entry Panel 
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NAME 
ACCOUNT 
ACCT 
ACCT2 
COINS 
COMPX 
COMPY 
DCLS 
LISTNEW 
MAIN 
TESTDIR 
UPDATE 


HHEND 43 


BROWSE - SPFDEMO.MYLIB.PLI 
COMMAND INPUT ===> 


VER .MOD 
01.00 
01.02 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 
01.00 


CREATED 
79701709 
79/01/09 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79704723 
79/01/09 
79/04/23 
79/01/09 


LAST MODIFIED 


79/01/09 
79/04/23 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/05/06 
79/01/09 


17:07 
14:52 
17:07 
16:20 
17:08 
12:39 
15314 
15:00 
17:08 
17:04 
17:08 


Figure 3. Browse ~- Member Selection List 


BROWSE - SPFDEMO.MYLIB.PLI(COINS) - 01.04 


COMMAND 


COINS: 


INPUT === 


- PROCEDURE OPTIONS (MAIN); 
DECLARE 


COUNT 
HALVES 


QUARTERS FIXED BINARY (31), 


DIMES 


FIXED BINARY (31), 


NICKELS FIXED BINARY (31), 
SYSPRINT FILE STREAM OUTPUT PRINT3 


DO HALVES = 
DO QUARTERS = 


DO DIMES = 
NICKELS = 
PUT FILE(SYSPRINT) DATACCOUNT,HALVES,QUARTERS,DIMES; NICKELS); 00140000 


COUNT = 
END; 


END; 


END; 


END COINS; 
283A BOTTOM OF DATA 3¢2636969636263626303022090200903-CAPS ON 


Figure 4. Browse - Data Display 


100 TO 0 BY -50; 
(100 - HALVES) TO 0 BY ~-253 


FIXED BINARY (31) AUTOMATIC INIT (13; 
FIXED BINARY (31), 


SCROLL 


-_ 
ooooc ororoeeo 


((100 - HALVES ~ QUARTERS)/10)*10 TO 0 BY -103 
100 ~- HALVES - QUARTERS - DIMES; 


COUNT + 13 


===> PAGE 
MOD 


' MOSTON 


KLEIN 

MOSTON 
MOSTON 
MOSTON 





LINE 00000 COLS 001 080 
SCROLL 


===> PAGE 
HIE HEH IEEE IEICE IEICE IEE IENIEIIEIEE TOP OF DATA 6363636363696 96 909696 026TH KK-CAPS ON-2%3¢ 


00010001 
00020000 
00030000 
00040000 
00050000 
90060003 
00070000 
00080004 
00090000 
00100000 
00110000 
00120000 
00130000 


00150000 
00160000 
00170060 
00180000 
00190001 
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SPF LIBRARIES 


6 


An SPF library is a collection oF code or data units, called mem- 
bers. Each library generally contains members with the same type 
of information. Figure 5 shows a sample set of five SPF libraries 


_ which contain Assembler source, COBOL source, TEXT (Cobject) 


modules, test data, and SCRIPT documentation. 


MEMBER MEMBER MEMBER MEMBER MEMBER 
A A D IJK D 


—————| MEMBER eee 
MEMBER D ————— MEMBER 
B Sr Q 


MEMBER |-——-—---—— 
—————— | MEMBER F MEMBER 
MEMBER E oo PQRS 
Cc 
—_oo MEMBER 
MEMBER ————— XYZ 





ASSEMBLE ‘COBOL TEXT DATA SCRIPT 


Figure 5. SPF Library Organization 


SPF libraries are identified by project name, library name, and 
type, where: 


° "project name” is the common identifier for all libraries 
belonging to the same project. 


e "library name" jdentifies the particular set of libraries, 
such as MASTER, TEST, or ALICE. 


® "type" identifies the type of information in the library, 
such as ASSEMBLE, COBOL, TEXT Cobject modules), DATA, or 
SCRIPT. Except for TEXT, the SPF type qualifier need not con- 
form to the standard CMS naming conventions. 


Most projects will require a hierarchy of related libraries to 
maintain effective version control over the programming develop- 
ment process and to-reduce contention in library usage. Figure 6 
shows a sample three-level hierarchy for a project, consisting of 
a set of master libraries, a set of test libraries, and three sets 
of development (private) libraries identified by user id. 


New members or members undergoing changes will generally reside 
in the development libraries. A test library may be used to accu-~ 
mulate members which have been unit tested and are ready for inte~ 
gration test. A master library contains fully tested members, 
which may correspond to a previously released version of the pro- 
gram. Typically, a higher degree of control is maintained over 
the higher level libraries than the development libraries. 
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MASTER 





Figure 6. Hierarchy of SPF Libraries 


SPF allows concatenation of up to four SPF libraries during source 
editing, compilation, assembly, or SCRIPT/VS processing (plus 
additional MACLIBs for compilations and assemblies). Generally, 
the lowest level library is concatenated ahead of the next higher 
level library, and so on, in bottom-to-top order. For the hierar- 
chy shown in Figure 6, a typical concatenation sequence might be 
library LARRY, followed by TEST, followed by MASTER. The concat- 
enation applies to libraries of the same type, and is restricted 
to libraries which belong to the same project. 


The purpose of concatenation during editing is to provide down- 
ward copying of a member from a test or master Library to a devel- 
opment library. The edited member is saved in the development 
library (the first library in the concatenation sequence), while 
the unchanged version remains in the test or master library. When 
the new version is fully tested, it may be promoted back to a 
higher level library by means of the move/copy utility. 


The purpose of concatenation during language processing is to 
facilitate inclusion of source seqments via INCLUDE or COPY 
statements Cor SCRIPT "“imbed" controls), and to allow debugging 
of new or modified programs without altering the contents of the 
test or master Libraries. The output from a compilation or assem- 
bly Cobject module) is stored in the lowest level TEXT library 
(the first library in the concatenation sequence). 


SPF libraries are maintained internally as CMS files. Each SPF 
library may consist of a set of CMS sequential files, or it may be 
a MACLIB or TXTLIB (for TEXT libraries only). The particular 
organization is designated when the library is specified to SPF 


via the file utility Coption 3.2). 
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PARAMETER SPECIFICATION 


Several entry panels require speci fication of an SPF library or 
CMS file identifier, and (when applicable) a read and/or update 
password. These are described in the following paragraphs. 


Library and File Identification 


To specify a member of an SPF library, the user must enter a 
project name, library name, type qualifier, and member name. Each 
of these may contain up to eight alphameric characters, of which 
the first character must be alphabetic. SPF automatically issues 
LINK and ACCESS commands, when required, to access the minidisk on 
which the SPF library resides. 


SPF panels prompt the user for each component of the library iden- 
tification as follows: 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MENBER 


vvvv 


(BLANK FOR MEMBER SELECTION LIST) 





If the member name is not specified, a member selection list will 
be displayed. 


When the library identification is displayed on a title line or 
message, the following shorthand notation is used: 


project. library. type(member) 
That is, the project name, library name, and type qualifier are 
separated with periods, and the member name is enclosed in paren- 
theses. 


Some panels allow a concatenated sequence of up to four SPF 
libraries. For example: 


SPF LIBRARY 


PROJECT SAMPLE 
LIBRARY ==s=> TEST ==e> MASTER ===> 
TYPE 

MEMBER (BLANK FOR MEMBER SELECTION LIST) 






In this example, three COBOL libraries belonging to project SAM- 
PLE would be concatenated in the following order of search: 


SAMPLE.LARRY.COBOL 
SAMPLE.TEST.COBOL 
SAMPLE.MASTER.COBOL 


CMS files may also be specified on panels, as follows: 


CMS FILE: 


FILE ID 

MEMBER (FOR MACLIB OR TXTLIB) 
IF NOT L 
OWNER 'S DEVICE ADDR. ===> LINK ACCESS MODE ===> _ 






The CMS file id is entered according to normal CMS conventions, 
j.e.: Filename, filetype, and Coptionally) filemode, separated by 
one or more blanks. 6 = 
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If both an SPF library and a CMS file id are specified on the same 
panel, the CMS file id is used. In other words, to specify an SPF 
library, the CMS file id must be blank. 


If the CMS file is on a minidisk which is not currently linked and 
accessed, SPF will issue the appropriate LINK and ACCESS com- 
mands, based on user-specified LINK command parameters Cowner's 
user id, virtual device number, and link access mode). 


If a filemode is specified as part of the CMS file id, the speci- 
fied filemode letter will be used in issuing the ACCESS command. 
Otherwise, the first available (currently unused) filemode letter 
will be used. Minidisks which are linked and accessed by SPF for 
the user will remain linked and accessed only as long as they are 
being used by a given function (e.g., edit). 


Passwords 


SPF supports the use of VM password protection for read-only or 
read/write minidisks. Passwords may be specified as follows: 





Non-display input fields are used so that the passwords will not 
appear on the screen. 


If the minidisk containing the SPF library or CMS file is password 
protected, the user must enter one or both passwords. Only the 
read password need be supplied for read-only functions (e.g., 
browse). The update password must be supplied for functions that 
cause data to be written to the minidisk Ce.g., edit). In edit, 
if concatenated SPF libraries are specified that reside on two or 
more minidisks, the first library is linked for update and the 
higher level libraries are linked read-only. Therefore both a 
read and update password may be required. 


Note: The "update" password may require either the write (CW) or 
multiple write (MW) password depending upon how the SPF library 
was specified (see utility 3.2) or, for a CMS file, depending on 
what was specified on the panel for link access mode. 


USER PROFILES 


SPF “remembers™ information on behalf of each user in a user pro- 
file. This allows SPF to prefill panel input fields with the val- 
ues that were last entered by the user on the same (or similar) 
panel. In some cases, default values are provided if the user has 
not specified otherwise. 


Information maintained in a user profile includes: 


Project name, library name(s), type, and password 

Job statement information (for CMS batch submission) 
Defaults for console, log, and list processing 
Terminal characteristics and PF key definitions 

Edit profiles, including mask, tabs, and bounds 
Current scroll amount (browse, edit, and member lists) 
Processing options for each of the language processors 
File specification/information parameters 


e*eee¢¢et@¢ 


This information is automatically maintained from one session to 
another. A new user will have to enter certain information the 
first time it appears. But from that point on, the user simply 
verifies the information and makes whatever changes are desired 
before proceeding. 
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PROGRAM ACCESS AND FUNCTION KEYS 


The program access (PA), and program function (PF) keys are used 

to request commonly used operations. Keys that are not needed for 
SPF-defined key operations may be equated to edit and browse pri- 

peek aaa ea or edit line commands, using the SPF parms option 
option 0.3). 


The default key arrangement for the 3-by-4 key pad Cright-hand 
side of the keyboard) jis shown in Figure 7. These are PF keys 
1-12 on a 12-key terminal, or keys 13-24 on a 24-key terminal. 

For 24-key terminals, PF keys 1-12 have the same defaults as keys 


13-24. It is strongly recommended that users of 24-key terminals 
continue to use the key pad (13-24) for SPF-defined operations, 


and redefine PF keys 1-12 to edit and browse commands. 
PF1l / 13 PF2 7 14 PF3 7 15 : 
HELP SPLIT END 
PF6 / 18 
CHANGE 


PFS / 16 PF5 / 17 
RETURN FIND 
PF7 / 19 PF& / 20 PF9 / 21 
SWAP 
PF12 #7 24 
CURSOR 


(UP) 
PFIO / 22 

The two PA keys are defined as follows. They may not be redefined 

by the user. 


PAl PA2 



















ATTENTION RESHON 









(DORN) 








PF1ll / 23 


—»> 


(RIGHT) 






<q 


(LEFT) 





Figure 7. Default Program Key Arrangement 


ATTENTION (PAL) Causes an immediate return to CP mode. This key 
should not be used, since it bypasses normal SPF 
termination. If it is pressed by mistake, a 
BEGIN command should be entered to resume SPF. 


RESHOW CPA2) Redisplays the contents of the screen. May be 
useful if the ERASE or CLEAR key was pressed 
accidently, or if unwanted information has been 
typed but ENTER Cor a PF key) has not yet been 
pressed. Note that SPF does not support use of 

the Field Mark character (same key as PA2). 
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The SPF-defined PF key operations are described below. See 
Figure 7 for the default key assignments. 


HELP Displays additional information about an error message 
or tutorial information about SPF commands and options. 


SPLIT Causes split screen mode to be entered, or changes the 
location of the split line (see "Split Screen"). 


END Terminates the current operation and returns to the 
previous menu. If the primary option menu is displayed, 
this key terminates SPF. 


RETURN Causes an immediate return to the primary option menu, 
bypassing any intermediate menus. (Logically equiv- 
alent to repeated use of the End PF key.) May also be 
used to go directly from one option to another, without 
displaying the primary option menu, as follows: In any 
menu or panel input field that is preceded by an arrow 
(===>), enter an equal sign (=) followed by a primary 
option. Then press the Return PF key rather than ENTER. 


FIND Repeats the action of the previous FIND command or the 
FIND part of the most recent CHANGE command Capplies to 
browse and edit only). 


CHANGE Repeats the action of the previous CHANGE command 
Capplies to edit only). 


UP Causes a scroll up (see "Scrolling™). 
DOWN Causes a scroll down (see "Scrolling"™). 
SWAP Moves the cursor to wherever it was previously 


positioned on the other logical screen (see "Split 
Screen"). 


LEFT Causes a scroll left (see "Scrolling"™). 
RIGHT Causes a scroll right (see "Scrolling™). 


CURSOR Moves the cursor to the first input field on line 2 
Cnormally, the option selection or command = input 
field). Pressing this PF key again causes the cursor to 
be moved to the second input field on line 2, if any 
Cnormally the scroll amount field). 


PRINT Causes a "snapshot" of the screen image to be recorded 
in the SPF list file. 


PRINT-HI Same as PRINT except that high intensity characters on 
the screen are printed with overstrikes to simulate the 
dual intensity display. Should not be used if list out- 
put is to be spooled to a printer which does not support 
suppress~—space carriage control. 


NOP Causes the PF key to be functionless. 


The PRINT, PRINT-HI, and NOP functions have no default PF key 
assignments. 


The only PF key function that is required is the End key. Other 
keys may be assigned to edit and browse commands, or to PRINT, 
PRINT-HI, or NOP. 


Caution on use of 3270 RESET key: On a 3277 or 3275, when the key- 
board is locked during SPF processing, do not press RESET and 
attempt to enter additional information or use a PF key. Such 
action may produce unpredictable results. 
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SCROLLING | 


12 


During edit and browse, the information to be displayed will gen- 
erally exceed the screen size. Scrolling allows the screen "win- 
dow" to be moved up, down, left, or right across the information. 
A member list can also be scrolled up and down, if it exceeds a 
single screen length. 


Four program function (PF) keys are used for scrolling -- one for 
each direction. Whenever scrolling is allowed, a scroll amount is 
displayed at the top of the screen (line 2). This determines the 
number of lines Cor columns) scrolled with each use of a Scroll PF 
key. The user may change the scroll amount by moving the cursor 
to the scroll field and overtyping the displayed amount. Valid 
scroll amounts are: 


° A number from 1 to 9999 - specifies the number of lines Cup or 
down) or columns Cleft or right) to be scrolled. 


° PAGE - specifies scrolling by one page. 
e . HALF - specifies scrolling by a half page. 


° MAX ~- specifies scrolling to the top, bottom, left margin, or 
right margin, depending upon which Scroll PF key is used. 


° CSR ~- specifies scrolling based on the current position of the 
cursor. The line or column indicated by the cursor is moved 
to the top, bottom, left margin, or right margin of the 


screen, depending upon which Scroll PF key is used. If the. 


cursor 35 not in the body of the data, or if it is already 
positioned at the top, bottom, left margin, or right margin, a 
full page scroll will occur. 


In edit, left and right scrolling is also affected by the current 
setting of the bounds. See description of BOUNDS command. 


For scrolling purposes, a “page” is defined as the amount of 
information currently visible on the logical screen. In split 
screen mode, for example, a browse display might have 12 lines by 
80 columns of scrollable data. In this case, a scroll amount of 
HALF would move the window up or down by 6 lines, or right or left 
by 40 columns. 


The current scroll amount is saved in the user profile. Three 
different values are saved -- one for browse, one for edit, and 
one for member lists. When the user overtypes the scroll amount, 
the new value remains in effect until it is again changed by the 


user. The value MAX is an exception; following a MAX scroll, the 


scroll amount reverts to its previous value. 


Any valid scroll amount can also be entered in the command input 


field and used in conjunction with a Scroll PF key. For example: 





If a Scroll PF key is pressed, the value in the command area will 
‘be used, overriding the normal scroll amount, without causing a 
change to the scroll field. This results in a one-time override; 
the value in the command area is blanked out after scrolling 
occurs. 


If some key other than a Scroll PF key is pressed, the value in 
the command area will be interpreted as a command and will proba- 
bly result in an error message. 
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OVERTYPING OF SCROLL AND MULTIPLE CHOICE PARAMETERS 


To reduce keystrokes, the scroll amount field can be changed by 
overtyping the first character(s) only: 


e To change the scroll amount to PAGE, HALF, MAX, or CSR only 
the first character need be overtyped with "P"™, "H™, "M™, or 
"ct raspectively. 


° In the scroll amount field, any alphabetic characters follow- 
ing a number are ignored. For example "3AGE" is interpreted 
as way 


The same rule applies to multiple choice parameters in cases where 
the first letter uniquely defines the option. Examples: 





To change these options to YES or MOD, only the first character 
need be overtyped with "Y" or "M" respectively. 


SPLIT SCREEN 


Split screen mode allows the user to partition the display screen 
into two logical screens. The top and bottom screens are treated 
as though they were independent terminals. Functions that can be 
performed simultaneously on two separate terminals can be done on 
the top and bottom screens. Functions that are in conflict on two 
separate terminals Cediting the same member of an SPF library or 
the same CMS sequential file, or browsing the same CMS file) will 
also be in conflict when simultaneously attempted on the top and 
bottom screens. 


Split screen mode is entered by pressing the Split PF key, but 
first the user moves the cursor to the desired location for the 
split. The line containing the cursor will become the split line 
and will be identified by a row of periods. When the Split PF key 
is pressed, all lines below the cursor are treated as the bottom 
screen. The first display to appear on the bottom screen is the 
primary option menu. An example is shown in Figure 8. 


Note: Since only one logical screen is active at a time, the user 
cannot split the screen while executing a foreground compilation 
or a CMS command. 





The split location may be repositioned at any time by moving the 
cursor to the desired line and pressing the Split PF key again. 
Repositioning may be required to bring an entire panel or tutorial 
page into view. 


In split screen mode, one or the other of the logical screens is 
considered active at any point in time. Any interrupts, such as 
the operation of program function keys, are interpreted as having 
meaning for the active screen. The location of the cursor identi- 
fies which of the two screens is active. To switch from one 
screen to the other, the cursor movement keys may be used or the 
Swap PF key may be pressed. 


In addition to moving the cursor to the other logical screen, the 
Swap PF key will automatically reposition the split if either log- 
ical screen is less than five lines long. For example, if the 
split occurs at the third line down from the top and the cursor is 
on the bottom screen, pressing the Swap PF key will move the cur- 
sor to the top screen and reposition the split to the third line 
up from the bottom. This allows the use of two screens in 
"flip-flop" mode, with each logical screen consuming nearly all 
lines of the physical screen. 
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BROWSE ~ SPFDEMO.MYLIB.PLI(COINS) - 01.04 ‘LINE 00000 COLS 001 080 
COMMAND INPUT ===> SCROLL ===> PAGE 
SEIEIENE NESE EEE IE IE IE 9 9 EEE E96 98 9696969898909 TOP OF ‘DATA 28H HEE EI IRIE-C A PS ON-%% 
COINS: : ; . 00010001 
PROCEDURE OPTIONS (MAIN); : 00020000 
DECLARE . a 00030000 
COUNT . FIXED BINARY (31) AUTOMATIC INIT (1), : 00040000 
HALVES FIXED BINARY (31); : 00050000 
QUARTERS FIXED BINARY (31), , : re > 00060003 
SPF-VM PRIMARY OPTION MENU 
SELECT OPTION ===> _ 
STEPHENS 
12:47 
3277 
12 


SPECIFY TERMINAL AND SPF PARAMETERS ' “TIME 
DISPLAY SOURCE DATA OR OUTPUT LISTINGS TERMINAL 
CREATE OR CHANGE SOURCE DATA PF KEYS 
PERFORM SPF UTILITY FUNCTIONS 

COMPILE, ASSEMBLE, LOAD, OR TEST 

COMPILE, ASSEMBLE, OR LOAD 

ENTER CMS COMMAND OR EXEC 

TEST DIALOG OR CONVERT MENU/MESSAGE FORMATS 
DISPLAY INFORMATION ABOUT SPF 

TERMINATE SPF USING CONSOLE, LOG, AND LIST DEFAULTS 


SPF PARMS 
BROWSE 
EDIT 
UTILITIES 
FOREGROUND 
BATCH 
COMMAND 
“SUPPORT 
TUTORIAL 
EXIT 


0 
1 
2 
3 

4 
5 
6 
7 
: 
x 


PRESS END KEY TO TERMINATE SPF 





Figure 8. Split Screen Example 


Split screen mode is terminated by ending SPF processing on either 
logical screen Ci.e.,» by pressing the End PF key or by entering 
option "X" when the primary option menu is displayed). The 
remaining logical screen is then expanded to its full size. Split 
screen may also be terminated by typing =X Cexit option) in the 
command input area and pressing the Return PF key. 


HELP INFORMATION 


The help function allows the user to obtain additional informa- 
tion about a message that has been displayed in the upper 
right-hand corner of the screen, or general information about an 
SPF command or option. - 


If a message is displayed, pressing the Help PF key causes a 
one-line explanation to be ‘displayed. If this explanation is not 
sufficient, the user may obtain further information by pressing 
the Help key again. This causes an entry into the appropriate 
section of the tutorial. If a message is not displayed, the Help 
eee corte a direct entry into the appropriate section of the 
utoria 


Once in the tutorial, the End PF Rey causes a cone to the screen 
that was being viewed when the Help key was originally pressed. 
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LIBRARY ACTIVITY STATISTICS 


Under user option, the SPF editor will automatically generate and 
maintain the following activity statistics for each member of an 
SPF library. 


Version Number: . Initialized to 1 when the member is created. 

Modification Level: Number of times this version has been 
modified. 

Creation Date: " tihen this version was created. 


Date/Time Modified: When this version was last modified. 

Current No. Lines: | Current size (number of records). 

Initial No. Lines: Initial size of this version. 

No. Modified Lines: Number of lines added or changed since this 
version was created. (Zero for unnumbered 

data.) 

User Id: Who created or last updated this version. 

The version number and/or user id may be changed via the "reset 

SPF statistics" utility Coption 3.5). The statistics are dis- 

played next to each member name on member selection lists, and may 

be printed by requesting an "index listing” via the library utili- 

ty Coption 3.1). 

The following formats are used for display and printing: 


° For version number and modification level: VV.MM Ce.g., 
"LEVEL 02.15" means version 2, modification 15). 


e For creation date and date last modified: YY/MM/DD (e.g.; 
"80712727" means December 27, 1980). | — 


e For time last modi fied: HH:MM Ce.g., "17:20" means 5:20 PM). 
During browse and edit, the current version and modification lev- 
el is displayed in the title area (line 1) following the library 
and member name. 


On member selection lists, the following abbreviations are used 
for column headings: 


LIB - Library number (see below) 

VER.MOD - Version number and modification level 
CREATED - Creation date 

LAST MODIFIED - Date and time last modified 

SIZE - Current number of lines 

INIT - Initial number of lines 

MOD - Number modified lines 

ID - User id 


The LIB column is displayed only if a concatenated sequence of SPF 
libraries was specified. It indicates the library (1, 2, 3, or 4) 
in which the member was found. 
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LIST AND LOG FILES 


VIRTUAL 


Under user option, a listing of any source module that is created 
or modified by the SPF editor may be automatically recorded in an 
SPF listing file. Source listings and other types of printed out- 
put may also be obtained from the SPF utilities. A screen "snap- 
shot™ may be obtained by pressing the Print PF key. 


SPF also maintains a log of significant user activities, includ- 
ing a record of files and SPF library members which were modified 
via edit or utility options, batch jobs which were submitted, etc. 
See Appendix B for a discussion of SPF listing and log formats. 


The SPF list and log files are generated automatically, and reside 
on the user's A-disk during the SPF session. Their CMS file ids 
are: 


SPFLIST LISTING 
SPFLOG LISTING 


These files may be printed upon termination of SPF. A user option 
is available to prevent generation of the SPF log file (see SPF 
parms, option 0.2). Generation of the SPF list file may be 
avoided by simply not requesting any SPF print functions. 


CONSOLE 


During SPF operation, all CMS commands and EXECs issued by SPF are 
spooled to the user's virtual console, including commands 
requested by the user Cunder options 4 and 6) and commands which 
are automatically executed on behalf of the user Csuch as LINK and 


ACCESS commands). 


Upon termination of SPF, the user may specify if the virtual con- 
sole is to be deleted or kept. If the user specifies that the 
console is to be deleted, SPF will purge the console and set it to 
“stop” status. If the user specifies that the console is to be 
kept, SPF will leave the console in “start” status. If the con- 
sole remains in "start" status, it will be closed (released for 
printing) by CMS when the user logs off. 
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INVOCATION AND TERMINATION 


Before SPF is invoked, the user's virtual device 191 must be 
accessed as the A-disk. SPF assumes that this minidisk is avail- 
able at all times in read/write mode, and that no other user has 
write access to it. 


The SPF program development facility is invoked by entering the 
command "ISPF™. CAn SPF command may be established as an alias of 
ISPF.) The first display is the primary option menu (Figure 9). 
The user may select an option by typing a one-character code in 
the option field and pressing the ENTER key, e.g., 


SELECT OPTION ===> 2 


to select the edit option. 


SELECT OPTION ===> 


USERID - STEPHENS 
0 SPF PARMS - SPECIFY TERMINAL AND SPF PARAMETERS TIME ~ 12:47 
1 BRCWSE - DISPLAY SOURCE DATA OR OUTPUT LISTINGS TERMINAL - 3277 
2 EDIT ~ CREATE OR CHANGE SOURCE DATA PF KEYS - 12 
3 UTILITIES - PERFORM SPF UTILITY FUNCTIONS 
4 FOREGROUND - COMPILE, ASSEMBLE, LOAD, OR TEST 
5 BATCH ~ COMPILE, ASSENSLE, OR LCAD 
6 COMMAND ~ ENTER CMS COMMAND OR EXEC 
7 SUPPORT - TEST DIALOG OR CONVERT NENU/MESSAGE FORMATS 
T TUTORIAL - DISPLAY INFORMATION ABOUT SPF 
X EXIT - TERMINATE SPF USING CONSOLE, LOG, AND LIST DEFAULTS 


PRESS END KEY TO TERMINATE SPF 


Figure 9. Primary Option Menu 


For options that have secondary level menus Coptions 0, 3, 4, 5, 
and 7), the user may bypass the second menu by typing two numbers, 
separated by a decimal point, on the primary option menu. For 
example, entering "3.1" on the primary menu has the same effect as 
entering "3" on the primary menu and "1" on the secondary menu. 


On initial entry, the user may also bypass the primary Cand sec- 
ondary) menus by entering an initial option as a parameter to the 
ISPF command. Examples: 


ISPF 2 - to go directly to edit 
ISPF 3.1 - to go directly to utility suboption 1 
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The SPF primary options are: 


° SPF PARMS - To specify SPF parameters and defaults, includ- 
ing: terminal type, number of program function (CPF) keys, 
default pad character for input fields, defaults for process- 

ing console, log, and list files, and PF key definitions. 


° BRONSE - To display source data or output listings. Browse is 
intended primarily for viewing large files such as compiler 
listings or dumps. 


e EDIT ~ To create or change source data, including program 
code, test data, or documentation. Unlike browse, edit reads 
the selected member (Cor entire sequential file) into virtual 
storage and retains it there during edit operations. 


° UTILITIES - To print, rename, or delete SPF library members or 
CMS files; specify SPF libraries; move or copy data; display 
or print SPF project listings; reset SPF library statistics; 
initiate spool output; retrieve data from the virtual reader; 
retrieve SPF libraries (via tape) from an MVS system: or for- 


° FOREGROUND - To execute language processing programs in the 
foreground, including: Assembler, COBOL, FORTRAN, PL/I 
(checkout or optimizer), PASCAL, and COBOL or FORTRAN inter- 
oad debug. Also included is an interface to the LOAD com- 
mand. 


e BATCH - To generate and submit job statements and command 
streams for batch execution of IBM language processing pro~ 
grams, including: Assembler, COBOL, FORTRAN, PL/I (checkout 
or optimizer), and PASCAL; or for batch LOAD. 


° COMMAND. —- To enter a CMS or CP command, or EXEC, during exe~ 
cution of SPF. 


e SUPPORT - To test a panel or dialog function; set or examine 
dialog variables; convert old format selection and tutorial 
menus to new format panels; or convert old format messages to 
new format. 


° TUTORIAL - To obtain immediate online instruction in the use 
of SPF. The tutorial may be viewed sequentially from begin- 
ning to end, or randomly by selecting topics from the table of 
contents or alphabetized index. The tutorial may also be 
entered from other SPF options by means of the Help PF key. 


To terminate SPF, the user must be out of split screen mode. Two 
termination options are available from the primary option menu: 


1. The End PF key may be pressed to display the SPF termination 
panel (Figure 10) for specification of console, log, and list 
processing. 


2. Option "X" may be entered to terminate SPF with user defaults 
for processing console, log, and list files, as specified via 
SPF parms Coption 0.2). If no defaults have been specified, 
option "X" causes the termination panel to be displayed. 


Note: Option "X™" may also be used with the Return PF key to 


immediately terminate split screen or, in single screen mode, to 
immediately terminate SPF from any menu or entry panel, as fol- 
lows: In any panel input field or command line, enter an equal 
sign (=) followed by an X. Then press the Return PF key. 


The termination panel allows the user to specify whether the vir- 
tual console is to be deleted (purged and set to "stop" status) or 
kept Cleft in "start" status), and whether the log and list files 
are to be printed, deleted (erased), or kept without printing. 
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If the log and/or list files are to be printed, the following 
spool parameters may be specified: 


° Number of copies - if more than one copy is desired. 
® Spool class - for other than class A. 


° "For" user - to spool the output to another user's virtual 
printer on the same VM system Cignored if either 
"Yuser/machine id" or "node/link id" is speci fied). 


° 3800 keywords - if output is directed to an IBM 3800 printer 
which is attached to the CMS system as a virtual spooling 
device. See description of SPOOL command in VM/SP CP Command 
Reference for General Users, $€19-6211. 


° User/machine id - to spool the output to the virtual reader of 
another user or machine. 


° Node/link id - if the destination is a remote node on the net- 
work (valid with either "user/machine id” or "tag text", but 
not both). 

° Tag text - to specify control parameters for printing on a 


remote non-VM system. See description of TAG command in 


¥VM7370_ RSCS Networking Program Reference and Operations 
Manual, SH24-5005. 


Once the termination options have been entered, the ENTER key is 
pressed to complete termination. The screen is cleared, one or 
more termination messages is displayed, and the user is returned 
to CMS. 


SPECIFY DISPOSITION OF CONSOLE, LOG, AND LIST FILES 
ENTER/VERIFY PARAMETERS BELOW: 


CONSOLE PROCESS OPTION == 
LOG PROCESS OPTICN == 
LIST PROCESS OPTION == 


D_ (KOR D) 


=> P (Ps; Ky OR D) 
=> Pp (P, K, OR D} 


VALID PROCESS OPTIONS: 
P - PRINT FILE (AND DELETE) 
K - KEEP FILE - DO NOT PRINT 
D - DELETE (PURGE) FILE - DO NOT PRINT 


LOG/LIST SPOOL OPTIONS: 
NUMBER OF COPIES SPOOL CLASS ===> A ‘FOR’ USER ===> 


3800 KEYRORDS 


FOR SPOOLING LOG/LIST TO ANOTHER PERSON OR MACHINE: 
USER/MACHINE ID = 
NODE/LINK ID = 
TAG TEXT = 


PRESS ENTER TO COMPLETE SPF TERMINATION 
PRESS END KEY TO RETURN TO PRIMARY OPTION MENU 





Figure 10. SPF Termination Panel 
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For any of the following SPF options, a member selection list will 
be displayed if an SPF library or a CMS MACLIB or TXTLIB is speci- 
fied but no member name is supPiveds 


Library Utility 

Move/Copy Utility 

Reset SPF Statistics Utility 
SCRIPT/VS Utility 


An example of a member list display is shown in Figure 11. The 


member selection list also shows the SPF statistics for each mem- 
ber of an SPF library. 


BROWSE ~ SPFDEMO.MYLIB.PLI -~---~~--~-0----wwnn nnn nn nnn nn nnn nnn nnnen canna nena n= 


COMMAND INPUT ===> _ SCROLL ===> PAGE 
NAME VER .MOD CREATED LAST MODIFIED SIZE INIT MOD ID 
ACCOUNT 01.00 79/01/09 79/01/09 17:07 21 21 0 KLEIN 
ACCT1 01.01 79/01/09 79/04/723 14:52 99 193 O KLEIN 
ACCT2 01.00 79/01/09 79/01/09 17:07 20 20 0 ORR 
COINS 01.04 79704724 79704724 16:20 19 19 4 ORR 
COMPX 01.00 79/01/09 79/61/09 17:08 GG G4 0 ORR 
COMPY 01.01 79/01/14 79761/14 12:30 13 13 1 ORR. 

DCLS 01.00 79/04/23 79/04/23 15:14 20 20 0 MOSTON 
LISTNEW | 01.02 79/04/723. 79/04/23 15:00 17 13 6 KLEIN 
MAIN 61.00 79/01/09 79/01/09 17:68 4 4G 0 MOSTON 
TESTDIR 01.02 79/04/23 79/705/06 17:04 30 43 10 MOSTON 
UPDATE 01.00 79/01/09 79/701/709 17:68 13 13 0 MOSTON 
XX END XH 

Figure 11. Member List Display 
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The member list may be scrolled up and down by means of the Scroll 
PF keys. In addition, a LOCATE command may be entered in the com- 
mand input field on line 2 of any member list display. Format: 


LOCATE member-name 


Command abbreviations: LOC, L 





This causes a direct scroll to the specified mamber name (i.e., 
the entry for the specified name will appear as the first line 
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following the header lines). If the specified name is not found, 
scrolling is to the member name which Cin the collating sequence) 
would immediately precede the specified name. 


SINGLE SELECTION MEMBER LISTS 


For browse, edit and the SCRIPT/VS utility, one member at a time 
may be selected from the list. The member may be selected in 
either of two ways: 


@ Move the cursor down the left-hand side of the screen and 


enter the single character "S" in front of the desired member 
name, or 


° Enter a SELECT command in the command input field on line 2. 


The format of the SELECT command is: 


SELECT member-name 


Command abbreviations: SEL, S$ 





Use of this command allows selection of a member which is not in 
the list. For edit, selection of a nonexistent member jis the 
mechanism for creating a new member. 


Upon termination of browse or edit (via the End PF key) the member 
list is redisplayed with. an automatic scroll to the member just 
processed. The user may then select another member or press the 
End PF key again to return to the browse or edit entry panel. 


Note: When the member list is redisplayed following browse or 
edit, it will not include new members which may have been created 
by another user (Cor, in split screen mode, on the other logical 
screen). To display an up-to-date list, return to the browse or 
edit entry panel, leave the member name blank, and press ENTER. 


MULTIPLE SELECTION MEMBER LISTS 


For the other utility options, multiple members may be selected 
from the list. <A single character code may be typed in front of 
one or more member name(s) before pressing the ENTER key. For the 
move/copy and reset utilities, the selection code is "S". For the 
library utility, the allowable codes are "P™ (for print), "R" Cfor 
rename), "D" (for delete), and "B" (for browse). 


Select member Cexcept library utility) 


Print member Clibrary utility only) 


Rename member Clibrary utility only) 
Delete member (library utility only) 
Browse member Clibrary utility only) 





When ENTER is pressed, the selected member(s) are processed anda 
confirmation indicator is displayed to the right of each member 
name that was processed. See description of the utilities for 
examples. The user may then select additional members (scrolling 


- to bring them into view, if necessary) or press the End PF key to 


return to the previous panel. 
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SPE PARMS COPTION 0) 


The SPF parms option allows the user to display and change a vari- 
. ety of SPF parameters at any time during the SPF session. Changes 
remain in effect until the user changes the parameter again, and 


are remembered across sessions. The parameter options menu is 
shown in Figure 12. 


SPF PARAMETER OPTIONS 
SELECT OPTION ===> 


1 TERMINAL - SPECIFY TERMINAL CHARACTERISTICS 
2 PRINT - SPECIFY SPF CONSOLE, LOG, AND LIST DEFAULTS 
3 PF KEYS =~ SPECIFY PF KEYS FOR 3277 TERMINAL WITH 12 PF KEYS 





Figure 12. SPF Parameter Menu 


The following describes each of the SPF parms functions, corre- 
sponding to the three options on the secondary menu. . 
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SPECIFY TERMINAL CHARACTERISTICS COPTION 0.1) 


When this option its selected, a panel is displayed (Figure 13) 
that allows the user to specify the terminal type, number of pro- 
gram function (PF) keys, the default pad character for panel input 
fields, and the mode of operation for a 3278 Model 5. 


The initial defaults for a new user are: 


Terminal Type ===> 3277 
Number of PF Keys ===> 12 
Input Field Pad ===> N 
Screen Format ===> DATA 


After these parameters have been reviewed or changed, the user can 
press the End PF key to return to the previous menu. 


TERMINAL CHARACTERISTICS 
ENTER/VERIFY PARAMETERS BELOW: 


TERMINAL TYPE S==> 3277_ (3277 - 3277/3275 DISPLAY STATION) 
- (3278 - 327873276 DISPLAY STATION) 


NUMBER OF PF KEYS =: (12 - TWELVE PROGRAM FUNCTION KEYS) 
(24 - TWENTY FOUR PROGRAM FUNCTION KEYS) 


INPUT FIELD PAD (N - NULLS) 
(B - BLANKS) 


SCREEN FORMAT ===> DATA (DATA - FORMAT BASED ON DATA WIDTH) 


(3278 MODEL 5 ONLY) (STD - ALWAYS FORMAT 24 LINES BY 80 CHARS) 
(MAX <- ALWAYS FORMAT 27 LINES BY 132 CHARS) 


Figure 13. Terminal Characteristics Panel 


Specification of terminal type allows SPF to recognize valid 
(displayable) characters. <A 3278 terminal can display 6 more 
characters than a 3277. Users of 32793 terminals should specify 
3278 as the terminal type, since a 3279 terminal has the same 
character set as a 3278. 


Note: One or more of following installation-dependent options for 
terminal type may also be included on this panel: 


3278CF - for 3278 Canadian French terminals 
S277KN - for 3277 Katakana terminals 
3278KN - for 3278 Katakana terminals 


SPF will automatically determine the terminal type during SPF 
initialization, and set it to the appropriate value. 
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SPF will automatically. set Cée change) the number of PF keys in 
the following cases: 


° If the terminal type is 3277, SPF will initialize the number 
of keys to 12 


° If the terminal type is 3278, SPF will initialize the number 
of keys to whatever was "remembered" from the user's last SPF 
session (for a new user, the number of keys is initialized to 
1 


° 


° If the user presses a PF key higher than 12, SPF will set the 
number of keys. to 24. 


SPF cannot sense the number of PF keys if the user switches from a 


3278 with 24 PF keys to a 3278 with 12 PF keys. In this case, the 
user must inform SPF of the number of PF keys via option 0.1. 
Otherwise, the incorrect set of "remembered" key definitions will 
be used (see option 0.3). 


Specification of a pad character controls the initial padding of 
panel input fields Cincluding selection menus) but not the data 
portion of an edit display. Within edit, null or blank padding is 
controlled with edit commands. 


Speci fication of screen format applies to 3278 Model 5 terminals 
only; it is ignored for other types of terminals. If DATA is 
specified, SPF will automatically switch between the larger "de- 
fault" mode characters (24 lines by 80 characters) and the smaller 
Ynative™ mode characters (27 lines by 132 characters), based on 
the width of the data to be displayed. If STD or MAX is speci- 
fied, the mode will not be switched. 
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SPECIFY CONSOLE, LOG, AND LIST DEFAULTS COPTION 0.2) 


When this option is selected, a panel is displayed that allows the 
user to specify default processing for the virtual console and for 
the SPF log and list files, to be used when SPF is terminated via 
primary option "X" (Figure 14). If default processing options 
have not been specified, primary option "X" will cause the SPF 
termination menu to be displayed. 


CONSOLE, LOG, AND LIST DEFAULTS 
ENTER/VERIFY PARAMETERS BELOW: 


CONSOLE PROCESS OPTION ===> _ (K OR D) LINES PER PAGE: 
LOG PROCESS OPTION ===> (P> K» D, OR N) LOG ===> 60 
LIST PROCESS OPTION =s==> (P, K OR D) LIST ===> 60 
VALID PROCESS OPTIONS: 

P - PRINT FILE CAND DELETE) 

K - KEEP FILE - DO NOT PRINT 

D - DELETE (PURGE) FILE ~- DO NOT PRINT 

N - DO NOT GENERATE LOG FILE 


NUMBER OF COPIES 
3800 KEYWORDS 


LOG/LIST SPOOL OPTIONS: 


=> 1 SPOOL CLASS ===> A ‘FOR' USER 
=> 


FOR SPOOLING LOG/LIS ANOTHER PERSON OR MACHINE: 
"TO' USER/MACHINE 
REMOTE NODE ID 
TAG KEYRORDS 





Figure 14. Console, Log, and List Defaults Panel 


The number of lines per page and spool parameters for printing the 
log and list files may also be specified. The initial defaults 
for new users are: 

Lines per page ===> 60 (for both log and list) 
Number of copies ===> 1 
Spool class ===> A 


No other SPF-supplied initial defaults are provided for the other 
parameters on this panel. 


Normal values for lines per page are: 


60 - for printing 6 lines per inch 
80 - for printing 8 lines per inch 


The virtual console is automatically started the first time SPF 
invokes a CMS command Ctypically, a LINK or ACCESS executed auto-~ 
matically on behalf of the user). Upon termination of SPF, the 
console may be kept Cin "start" status) or deleted Cpurged and set 
to "stop”™ status). An appropriate processing option for the con- 
sole would be: 


K ~- if the user normally runs with a virtual console 
D - if the user normally runs without a virtual console. 
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The SPF log file is created the first time the user performs some 
action which results in a log message, such as saving edited data 
or submitting a job to the batch machine. The SPF list file is 
created the first time the user requests a print function. 


For the log file, a process option of "N" may be specified to pre- 
vent generation of the log. Generation of the list file may be 
avoided by simply not requesting any print functions. 


See section entitled "Invocation and Termination" for ae dis- 
cussion of spool parameters that may be specified for the log and 
list. files. 


After the parameters on this panel have been reviewed or changed, 
the user can press the End PF key to return to the previous menu. 


SPF PROGRAM FUNCTION KEYS COPTION 0.3) 


When this option is selected, a panel is displayed that allows the 
user to spacify the mapping of the PF keys into specific functions 
(Figure 15). Before. selecting this option, the user. should 
ensure that the correct terminal type (3277 or 3278) and number of 
PF keys (12 or 24) has been specified via option 0.1. 


SPF maintains three different sets of key definitions for each 
user, as follows: 


3277 Cor 3275) with 12 PF keys 
3278 Cor 3276 or 3279) with 12 PF keys 
3278 Cor 3276 or 32739) with 24 PF keys 


The appropriate set of key definitions will be invoked based on 
the terminal type and number of keys (as specified via option 
0.1). The panel shown in the figure is for a 3278 with 24 PF keys. 


The allowable SPF-defined key functions are listed at the bottom 
of the menu. See section entitled "Program Access and Function 
Keys" for a description of these functions. More than one key can 
be assignad to the same function. A function need not be assigned 
to a key, with one exception: There must be at least one End PF 
key assigned within the first 12 keys. 


Entering a blank for any PF key definition causes the specified PF 
key to be assigned its SPF default. The default key definitions 
are discussed under "Program Access and Function Keys" and are 
also shown in Figure 15 
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PROGRAM FUNCTION KEY DEFINITION 
ENTER/VERIFY PARAMETERS BELOW FOR 3278 TERMINAL WITH 24 PF KEYS: 


Vv 


PFI 
PF2 
PF3 
PF4 
PF5 
PF6 
PF7 
PFS 
PF9 
PF10 
PF1L 
PF12 


HELP_ PF13 
SPLIT PF14 
END PF15 
“RETURN PF16 
FIND PF17 
CHANGE - PF18 
UP PF19 
DOWN PF20 
SWAP PF2l 
LEFT PF22 
RIGHT PF23 
CURSOR PFe4 


HELP 
SPLIT 
END 
RETURN 
FIND 
CHANGE 
UP 
DOWN 
SWAP . 
LEFT 
RIGHT 
CURSOR 


in Wu tt tt a an ton a 
VvVVV VV VV VV 

HoH WR HOT Gt fu th a tt 
VvvVVVV VV VV Vv 


VALID OPTIONS: (BLANK RESETS TO DEFAULT OPTION) 
HELP SPLIT END RETURN FIND CHANGE 
UP DORN SWAP LEFT RIGHT CURSOR 
NOP PRINT PRINT-HI 

OR EQUATE TO EDIT/BROWSE COMMAND: 
>CMD... (PRIMARY COMMAND) EXAMPLE: PF1O == 
:CMND... (EDIT LINE COMMAND) EXAMPLE: PF1l == 


> >TABS ON 
> il 





Figure 15. PF Key Assignment Panel (For 24-key Terminals) 


The user may equate a PF key to an edit or browse primary command, 
or to an edit line command, in the following manner: 


>string Causes the specified PF key, when used in edit or browse, 
to simulate the entering of a primary command. Example: 


PF10 ===> >FIND ABC 


Pressing PF10 when browsing or editing data will have 
the same effect as entering a FIND ABC primary command. 


:string Causes the specified PF key, when used in edit, to 
simulate the entering of a line command. Example: 


PF1il ===> :TF 
Pressing PF1l when editing data will have the same 
effect as entering the "TF" (text flow) Line command on 


whichever line the cursor 15 positioned when the key is 
pressed. 
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BROWSE COPTION 1) 


The browse option allows the user to display source data. and 
listinas stored in SPF libraries or CMS files with the following 
charactersitics: 


° Fixed or variable record formats 
e Logical record lengths up to and including 32767 bytes 


When browse is selected, and entry panel is displayed to allow the 
user to specify either an SPF library or CMS file id. A user id, 
virtual davice address, LINK access mode, and read password may 
also be specified, if needed, for linking to another user's vir- 
tual disk. See Figure 16. : 


For SPF libraries, MACLIBs, and TXTLIBs, the user can supply the 
name of the member to be browsed, or can leave the member name 
blank to request a member list from which a member may be 
selected. 


When the user has properly specified the data to be viewed, the 
first page of data is displayed. Two lines are reserved at the 
top of the screen for title information, short messages, command 
entry, and the scroll amount. The remainder of the screen con- 
tains the data (Figure 17). 


Note: Under browse, any invalid Cnon- displayable) characters in 
the data are displayed as periods. 





During browse, four-way scrolling is available via the Scroll PF 
keys. The FIND and LOCATE commands may also be used to scroll toa 
particular character string, line number, or symbolic label. 


Browse provides six commands, described in... the following 
sections, which may be entered in the command input field on line 


» 


2s 


LOCATE FIND 
COLS CAPS 
RESET HEX 


Browse may be terminated by pressing the End PF key, which causes 
a return to the previous display (either the member selection list 
or the browse entry panel). When return is to the member 
selection list, the member just browsed will appear at the top of 
the list. Another member may be selected from the List or the End 
key may be pressed again to return to the browse entry panel. 


When the entry panel is displayed, another file or member may be 
selected, or the End key may be pressed =e return to the primary 
option menu. 
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BROWSE - ENTRY PANEL 
ENTER/VERIFY PARAMETERS BELON: 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


“oa ton 
“ou et 
VVNVV 


(BLANK FOR MEMBER SELECTION LIST) 


CMS FILE: 
CBLMAIN COBOL Al_ 
(FOR MACLIB OR TXTLIB) 
SPECIFY: 
DEVICE ADDR. LINK ACCESS MODE ===> 





Figure 16. Browse - Entry Panel 


BRORSE ~- CBLMAIN CCBOL Al LINE 00000 COLS 001 080 
COMMAND INPUT ===> _ SCROLL ===> PAGE 
HRI HEHEHE HEHEHE IE NE HEHE HE HEH HEHEHE HEH HEH HHH HHKHHKKH TOP OF DATA xR K KIRK KHXH-CAPS ON-2 
000100 IDENTIFICATION DIVISION. 

000200 PROGRAM-ID. 'F20D1000'. 

000300 DATE-COMPILED. AUG. 20, 1979 

000400 ENVIRONMENT DIVISION. 

000500 CONFIGURATION SECTION. 

000600 SOURCE-COMPUTER. IBM-370. 

000700 OBJECT~COMPUTER. IBN-370. 

000800 INPUT-OUTPUT SECTION. 

000900 FILE-CCNTROL. 

001000 SELECT OLD-COMREC ASSIGN TO DA-S-DD1. 

o01100 SELECT D1~-REPORTS ASSIGN TO UR-S-DILOUT. 

001200 SELECT OPTION-CARD-FILE ASSIGN TO UR-~S~-SYSIN. 

001300 DATA DIVISION. 

001400 FILE SECTION. 

001500 FD OLO-COMREC 

601600 LABEL RECORD IS STANDARD 

001700 RECORDING MODE IS F 

001800 BLOCK CONTAINS 0 RECORDS 

001900 DATA RECORD IS CONRECI. 

002000 COMRECI. 

002100 02 DUNNY PICTURE X(520). 

002200 DI-REPORTS 

002300 LABEL RECORD IS OMITTED 

002400 RECORDING MODE IS F 

002500 BLOCK CONTAINS 133 CHARACTERS 





Figure 17. Browse - Data Display 
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During browse, the current position of the screen window is indi-~ 
cated by the line/column numbers in the upper right hand corner of 
the screen. The line number refers to the first data line current- 
ly being displayed (Ci.e., the first line after the two header 
lines). It indicates the relative position of that line in the 
data, and is unrelated to any sequence numbers that may be con- 
tained within the data. The "TOP OF DATA" message is treated as 
relative line zero. 


The LOCATE command may be used to scroll directly to a specified 
line number. It may also be used to scroll to a symbolic label, 
which must have been previously defined by the user, as follows: 
Scroll to any desired line and enter a label of the form: 

~XXXXXXX 
Cperiod followed by up to seven alphameric characters) in the com- 
mand input line. The label is treated as an internal symbol and 
equated to the top line on the screen. Labels are not retained 
upon exit from browse. 


Format of the LOCATE command: 


LOCATE line-number/label 


Command abbreviations: LOC, L 





Either a line number or a label must be entered as an operand. 


The "line-number"™ operand is a numeric value of up to eight digits 
Cleading zeros need not be typed), which refers to the relative 
line number as displayed in the upper right hand corner. 


The "label" operand consists of a period (.) immediately followed 
by up to seven alphameric characters. Scrolling is performed to 
the line which was previously equated to the label, as described 
above. 


Note: The period is mandatory when defining a label. It is 
optional when referring to a label in a LOCATE command unless the 
label begins with a numeric character, in which case the period is 
required to distinguish the label from a line number. 
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IDENTIFYING COLUMNS 


The COLS command causes a column identification line to be dis- 
played, temporarily overlaying the first data line. The RESET 
command terminates display of the column identification line. 
Formats: 


COLS 


Command abbreviation: COL 


RESET 


Command abbreviation: RES 





Neither command uses any parameters. 


An example of the column identification line is shown in 

Figure 18. The digits on the identification line indicate the 

"tens" positions, e.g., "1" indicates column 10, "2" indicates 

cone 20, etc. The plus signs (+) indicate the "fives" posi- 
ions. 


BROWSE ~ CBLMAIN COBOL Al LINE 00022 COLS 001 086 
COMMAND INPUT ===> _ SCROLL ===> PAGE 
mmm penn | enn pn enn penn Jorn pe en Gn rn pe een pe nn pn Jon tH 8 

002200 FD DI1-REPORTS 

002300 LABEL RECORD IS OMITTED 

002400 RECORDING MODE IS F 

002500 BLOCK CONTAINS 133 CHARACTERS 

002600 DATA RECORD IS DI-~LINE. 

002700 O01 DI-LINE. 

002500 02 COLUMNS PICTURE X(133). 

002908 FD OPTION-CARD-FILE 

003000 LABEL RECORD IS OMITTED 

003100 BLOCK CONTAINS 1 RECORDS 

003200 RECORDING MODE IS F 

003300 BATA RECORD IS O-C. 

003400 O1 O-C. 

603500 02 DUNMY PICTURE X(80). 

003600 WORKING-STORAGE SECTION. 

003700 OP-SUB PICTURE S99 COMPUTATIONAL VALUE 0. 
003800 PREV-DEVICE~TYPE-CODE PICTURE X VALUE ‘I. 
003900 PREV-ACTV-CODE PICTURE 9 VALUE 0. 
004000 PREV-PROB-CODE PICTURE 9 VALUE 0. 
004160 C-SWHITCH PICTURE X VALUE 'O'. 
004200 PREV-SYSTEM-CODE PICTURE X VALUE SPACE. 
004300 ; GSA-REF PICTURE XX. 

004400 UNIT-PRICE-NUMERIC PICTURE S9(8)V99. 
004500 BNL-NUMERIC PICTURE S9(8)V99. 
004600 PREV-MODEL PICTURE X(5) VALUE ‘O°. 





Figure 18. Browse - Column Identification Line 
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FINDING CHARACTER STRINGS 


The FIND command is used to find one or more occurrances of a 
specified character string. It allows special forms of character 
strings and several optional parameters to control: 


° Starting point and direction of search 
e Special conditions to control character string "match" 
° Column limitations on extent of search 


The command summary, which follows, describes the basic form of 
FIND which 1s most frequently needed. The remainder of this 
section provides detailed information about the various special 
features and options. 


Command Summary 
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The basic format for FIND is: 


FIND string [ALL] 





Command abbreviation: F 


The operands may be separated by blanks or commas. The ALL oper- 
and is optional, and may precede or follow the string. 


As a general rule, the strings are typed without delimiters. For 
example: 


FIND XYZ 
to find the next occurrence of XYZ. 
Strings may be delimited with either apostrophes (') or quotation 
marks ("). Delimiters must be used if a string contains imbedded 
blanks or commas, or if a string is the same as a command keyword. 
For example: 

FIND ‘EVERY QNE* 


toe find ane next occurrence of “EVERY ONE™ (which contains a 
blank). 


If the ALL operand is omitted, the FIND command searches for the 


next occurrence of the string starting at the current cursor 


location. (CI¥f the cursor is not in the data area of the screen, 
scanning starts at the beginning of the first line which is cur- 
rently being displayed.) Scrolling is performed, if necessary, to 
bring the string into view. The cursor is positioned under the 
string and a verification message is displayed in the upper 
right-hand corner of the screen. The Find PF key may be used to 
find each successive occurrence of the string. 


If the string is not found between the current cursor location and 
the end of data, a "BOTTOM OF DATA REACHED” message is displayed 
and the audible alarm is sounded Cif installed). The Find PF key 
may then be used to wrap to the top of data and continue search- 
ing. If the string is not found anywhere in the data a "NO xxxxx 
FOUND" message is displayed. 


If the ALL operand is typed, the FIND command searches for all 
occurrences of string starting at the top of the data, and posi- 
tions the cursor under the first occurrence. The verification 
message indicates the number of occurrences found. 
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Detailed Command Description 


The complete format for FIND, showing all optional parameters, 
follows: 


FIND string 


CNEXT/ALL/FIRST/LAST/PREV] 
rCHARS ARS /PREFIX/ SUFFIX/WORD] 


ol-1 Ecol-2]] 


Command abbreviation: F 
Keyword abbreviations: PRE (for PREFIX), SUF (for suffix) 





The operands may be separated with blanks or commas, and may be 
typed in any order except that col-2, if typed, must follow col-1l. 
The string operand is required; the others are optional. 


The "string™ operand specifies the string to be found. It may be 
specified in any one of the following forms: 


° Any string of characters not starting or ending with an apos-— 
trophe or quotation mark, and not containing any imbedded 
blanks or commas. 


° A delimited string: Any string starting and ending with an 
apostrophe (') but not containing imbedded apostrophes, or 
starting and ending with a quotation mark (") but not contain- 
ing imbedded quotation marks. 


° A hex string: Any delimited string of valid hexadecimal char- 
acters, preceded or followed with the character X. Example: 
X'C27B! 


e A text string: Any delimited string of characters, preceded 
or followed with the character T. See discussion under "Use 
of Text Strings.” Example: T'conditions for’ 


° A picture string: Any delimited string of picture charac- 
ters, preceded or followed with the character P. See dis- 
cussion under "Use of Picture Strings." Example: P".' 


° A single asterisk (*)}. This causes the previous value of 
"string" that was used in a FIND command to be used again. 
The previous value of a character string Creferenced via * or 


used by the Find PF key) is retained until the browse option 
is terminated Ci.e. until return to the primary option menu). 


Starting Point and Direction of Search 
The starting point, direction and extent of the search may be 
controlled by one of the following operands. 


NEXT Scan starts at the current cursor location and PESEESes 
forwards to find the next occurrence of the string. 


ALL Scan starts at the top of data and proceeds forwards to 
find all occurrences of the string. 


FIRST Scan starts at the top of data and proceeds forwards to 
find the first occurrence of the string. 


LAST Scan starts at the bottom of data and proceeds backwards to 
find the last occurrence of the string. 


PREV. Scan starts at the current cursor location and proceeds 
backwards to find the previous occurrence of the string. 


If this operand is omitted, the default is NEXT. 
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If the direction of the search is forward Ci.e, if FIRST, ALL, or 
NEXT was specified), pressing the Find PF key finds the next 


occurrence of the designated string. If the direction of the 


search is backward Ci.e., if LAST or PREV was specified), pressing 
the Find PF key finds the previous occurrence of the designated 
string. The other optional parameters (CHARS, WORD, PREFIX, SUF- 
FIX, col-1, and col-2) remain in effect, as specified on the last 
FIND command. 


The search proceeds until one or all occurrences of the string are 
found, or until the end of data is encountered. If the string is 
not found, one of the following actions takes place. 


“© For FIRST, LAST, or ALL ~ a "NO xxxxx FOUND" message is dis~ 


played in the upper right-hand corner of the screen. 
° For NEXT - a "BOTTOM OF DATA REACHED” message is displayed. 
° For PREV ~- a "TOP OF DATA REACHED” message is displayed. 


When "BOTTOM OF DATA REACHED" or "TOP OF DATA REACHED" is dis- 
played, the user may press the Find PF key to continue searching 
by wrapping to the top Cor bottom) of the data. If no occurrence 
is fehl anywhere in the data, a "NO xxxxx FOUND" message is dis- 
played. 


Conditions for Character String Match 


The conditions for a successful "match" with the string may be 
controlled based on whether the data string begins and/or ends 
with a non-alphameric character Ci.e., a special character or 
blank). The operands are: CHARS, PREFIX (may be abbreviated 
PRE), SUFFIX (may be abbreviated SUF), and WORD. In the following 
illustration, the underscored strings would be found, and the 
non-underscored strings would be ignored (skipped over). 


CHARS 'DO' DO po "DO DO (DONT) 


PREFIX ‘DO' DO (DONT) 


SUFFIX 'DO' po (DONT) 





WORD 'DO' DBO (DONT) 


If this operand is omitted, the default is CHARS. 


Column Limitations 
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If the "col-1" and "col-2" operands are typed (two integers 
separated by a comma or at least one blank), they indicate the 
starting and ending column positions for the search. If col-1 is 
specified without col-2, the string will be found only if it 
starts in the specified column. If neither col-1l nor col-2 is 
specified, the search will continue across all columns. 
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Use of Text Strings 


A text string, which may be used as the string in a FIND command, 
allows the search to be satisfied without regard to upper/lower 
case alphabetics. Example: FIND T*CONDITION NO. 1° would suc - 
cessfully find any of the following: 


CONDITION NO. 1 
Condition No. 1 
condition no. 1 
coNDitION nO. 1 


An ordinary delimited string, such as: FIND "CONDITION NO. 1° 
would find only the first example listed above. 


Within the text string itself, is is immaterial whether alphabet~ 
ics are typed in upper or lower case Ceven if CAPS mode is off). 
For example, all the following have the same effect: 


“FIND T'Edit Commands’ 
FIND T'EDIT COMMANDS'* 
FIND T’edit commands’ 


Use of Picture Strings 


A picture string, which may be used as the string in a FIND 
command, allows the search to be satisfied when a particular type 
of character is encountered. Special characters are used within 
ce Prordee string to represent the type of character to be found, 
as follows: 


STRING MEANING | 


P®=" - any character (don't care) 

P'-" - any non-blank character 

P*®*.* = any non-displayable Cinvalid) character 

P'#*’ - any numeric character (0-9) 

P*-* - any non-numeric character 

Pta* - any alphabetic character (upper or lowercase) 
P*<" - any lowercase alphabetic character 

P*>* - any uppercase alphabetic character 

P'S’ - any special character (not alpha or numeric) 


Any special characters other than the ones listed above are inval- 
id within a picture string. A picture string may also include any 
alphabetic or numeric characters, in which case the characters 
represent themselves. 


Examples of picture strings: 


P'###" - a string of three numeric characters 

P'- =" = any two non-blank characters surrounding a blank 
Pee - any non-displayable character 

P*® #°" - a blank followed by a numeric character 

P*#AB* - a numeric character followed by 'AB' 


Examples of FIND command using picture strings: 


FIND ire ~ find the next non-displayable character 
FIND P'-* 72 - find the next non-blank character in col 72 
FPR os? of - find the next line with a blank in col 1 


followed by a non-blank 


When the picture string P’." is used to find a non-displayable 
character, the hexadecimal representation of the character is 
shown in the confirmation message which appears in the upper 
right-hand corner of the screen. 
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CHARACTER STRING TRANSLATION 


If the character string operand of the FIND command contains 
alphabetic characters, they are automatically translated to upper 
case if browse is operating with CAPS mode on; they are left as-is 
(not translated) if browse is operating with CAPS mode off. 


gh mode may be turned on or off by using the CAPS command. For- 
mat: 


CAPS [ON/OFF] | 


If the ON/OFF operand is omitted, ON is the default. Under 
browse, CAPS mode is always initialized ON. 


Note: The "TOP OF DATA" and “BOTTOM OF DATA" lines contain an 
indication of the current mode. 


HEXADECIMAL DISPLAY 
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When browse is operating in HEX mode, three lines are displayed 
for each source line. The first line shows the data in standard 
character form. The following two lines show the same data in 

hexadecimal representation. See Figure 19. 


Note: The FIND command may also be used to find invalid characters 
or any specific hex character, regardless of the setting of HEX 
mode. See discussion of picture strings and hex strings under the 
FIND command. 


HEX mode may be turned on or off by using the HEX command. For- 
mats 


HEX [ON/OFF] [VERT/DATA] | 


The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. 


The VERT Cvertical) and DATA operands are valid only when HEX mode 
is turned on. VERT causes the hexadecimal representations to be 
displayed vertically (two rows per byte) under each character, as 
shown in Figure 19. DATA causes the hexadecimal representations 
to be displayed as a string of hex characters (two per byte). 
Since the hex string is twice as long as the data string, it con- 
sumes two rows. If this operand is omitted, VERT is the default. 
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BROWSE - BHEX SCRIPT Cl LINE 00000 COLS 001 080 
COMMAND INPUT ===> _ SCROLL ===> PAGE 
FER HIER IEEE HEHEHE HERE IE HSE HEHE HE IE EIEIO TOP OF DATA 2626969636626 99696 96 HEIEIEIEIEIMIER-CAPS ON-26 
CH3.HEXADECIMAL DISPLAY . 

7CF4CCECCCCCDCDSCCEDDCE 


A83B8571453941304927318 


WHEN BROWSE IS OPERATING IN HEX MODE, THREE LINES ARE DISPLAYED FOR EACH 
ECCDSCDDEECSCESDDCDCECDC4CD4CCESDDCCEGECDCC4DCDCESCOCSCCEDDCECC4CDD4CCCC 
685502 9662509206 75913957095085 7046456038 95503955201 950492 731854066 905138 


SOURCE LINE. THE FIRST LINE SHOWS THE DATA IN STANDARD CHARACTER FORM. 
EDEDCC4DCDC444ECC4CCDE ESDCDCGECDEESECC4CCEC4CDGEECDCCDC4CCCDCCECD4CDDD4 
26493503955B00385069923039550286620385041310950231541940381913359066 945 


THE FOLLOWING TWO LINES SHON THE SANE DATA IN HEXADECIMAL 
ECC4CDDDDECDCGEED4GDCDCESECDEGECCGECDC4CCEC4CD4CCECCCCCDCD 
385066336695703660395520286603850214504131095085714539413 


REPRESENTATION. SEE ¢FIGREF REFID='BHEX'.. 
DCDDCECDECECDD444ECC4 7CCCDCCADCCCCE77CCCE 744 
95795255313965B002550A6 97956 1956 94ED2857DBB 


CNOTE.THE FIND COMMAND MAY ALSO BE USED TO FIND INVALID CHARACTERS, 
7DDECGECC4CCOCSCDDDCDC4DCE4CDEDSCCGEECC4EDSCCDC4CDECDCC4CCCDCCECDE6 
A5635B385069540364415404180132602504254036069540955139403819133592B 


REGARDLESS OF THE SETTING OF HEX MODE. SEE DISCUSSION OF PICTURE 





Figure 19. Browse - Hexadecimal Display, Vertical 
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EDIT COPTION 2) 


38 


The edit option allows the user to create, display, and modify 
source data (program code, test data, documentation, etc.) stored 
in SPF libraries or CMS files with the following cherecracla lcs? 


e Fixed or variaele record formats 
e Logical record lengths up to and snetugins 255 By esey but not 
less than 10 bytes 


The edit entry panel is shown in Figure 20. For edit, a concat- 
enated sequence of SPF libraries may be specified. The concat- 
enated sequence applies to fetching of members to be edited. The 


libraries are searched in the designated order to find the member 


and bring it into working storage. When the edited member is 
saved, it is placed Cor replaced) in the first library in the con- 
catenation sequence regardless of which library it came from. 


If a member selection list is requested, it includes an indication 
of the library where the member was found (library 1, 2, 3, or 4). 
See Figure 21. 


If a CMS file id is specified and the file does not currently 
exist, the record format (RECFM) and logical record length 
CLRECL) may be specified on the panel. If these fields are left 
blank, the RECFM and LRECL which the user last specified for this 
filetype will be used. If the user has never specified a RECFM 
and LRECL for this filetype, the new file will be created with 


~RECFM=F (fixed) and LRECL=80. 


If the minidisk is password protected, an update password must be 
specified. For a concatenated sequence of SPF libraries which do 
not reside on the same minidisk, two passwords may be required: 
An update password for the first library in the concatenation 
sequence, and a read password for the other libraries (which must 
all be accessable via the same password). 


The edit entry panel also allows specification of a profile name, 
which may be entered to override the default edit profile. See 
description under "Edit Modes and Profiles." : 


SPF libraries must have been previously specified to SPF (see 
YFile Utility", option 3.2). Selection of a nonexistent CMS 
sequential file or a nonexistent member of a library allows cre-~ 
ation of a new file or member. 


‘The selected member or sequential file is read into virtual stor- 


age, where it is updated during edit operations. Use of virtual 
storage for edit work space results in high performance, but may 
require a large virtual machine. Warning messages will be dis- 
played if the amount of available virtual storage drops below 50K 
bytes. If all available storage is consumed an ABEND will occur, 
and the edit work space will be lost unless the user is operating 
with RECOVERY mode on. 


The edit data display is similar to a browse display except that 
each line consists of a 6-column Line command field followed by a 
72-column. data field (see Figure 22). The line command fields 
contain numbers that reflect the contents of the sequence numbers 
in the data. If the data has no sequence numbers, the line command 
fields contain numbers that start at 1 and are incremented by 1. 


Notes: 


1. Under edit, any invalid (non-displayable) characters are 
replaced on the screen (but not in the data) with attribute 
bytes, which display as blanks and may not be overtyped.. 


2. Invalid characters may be displayed and edited by entering 
HEX mode (see description of HEX command?) or by using the FIND 
and CHANGE commands. 
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EDIT - ENTRY PANEL 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 
PROJECT = 
LIBRARY 
TYPE 
MEMBER 


SPFDEMO 
MYLIB 
PLI 


sss> 


===> MASTER 


VvVVVv 


(BLANK FOR MEMBER SELECTION LIST) 


CMS FILE: 
FILE ID 
MEMBER 
IF KOT LINKED, SPECIFY: 
OWNER'S ID 


FOR NEW CMS FILE: 
RECFM == 
LRECL == 


(F OR V) 


> 
> 


=== DEVICE ADOR. ===> LINK ACCESS MODE ===> 


READ PASSWORD ===> UPDATE PASSWORD ===> 


PROFILE NAME ===> (BLANK DEFAULTS TO TYPE) 





Figure 20. Edit - Entry Panel 


EDIT --- SPFDOEMO.MYLIB.PLI 


COMMAND INPUT ===> ===> PAGE 


NAME 
ACCOUNT 
AcCT1 
ACCT2 
AcCT3 
ACCT4 
ACCT5 
COINS 
COMPX 
COMPY 
OCLS 
LISTNEW 


MAIN 
MINUS 
PLUS 
TESTDIR 
UPDATE 
ZCOMP 
*X*XEND 3% | 


Figure 21. Edit - Member Selection List 


LIB 
1 01.00 
01.02 
01.00 
01.02 
01.00 
01.01 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.03 
01.00 
01.02 
01.00 
01.01 


oa a er ee eC ey 


“VER.MOD CREATED 


79/01/09 
79/01/09 
79/01/09 
79701709 
79704723 
79/04/23 
79704724 
79/01/09 
79/01714 
79/04/23 
79/04/23 
79791709 
74710704 
79/01/09 
79/04/23 
79/01/09 
79/01714 


LAST MODIFIED 


79/01/09 
79/04/23 
79/01/09 
79/04/23 
79/04/23 
79/04/23 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/01/09 
79/01/09 
79/05/06 
79/01/09 
79/01/14 


17:07 
14:52 
17:07 
15:07 
15:04 
15:09 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
16:57 
17:08 
17:04 
17:08 
12:30 


= 
Oo 
i) 


ry 
KQoonoc or oh Poaouoodd 
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HOSTETL 
HOSTETL 
HOSTETL 
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SUMMARY 


EDIT --- SPFDEMO.MYLIB.PLI(COINS) ~- 01.04 ------ | hale teaeneaneteteeted COLUMNS 001 072 
COMMAND INPUT ===> _ ; SCROLL ===> HALF 
BERIT MIEN EMH MMH HH HHH NHI TOP OF DATA XIII IEE HIE HH IEE HE HEE DEH EE 
000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN); 

000300 . DECLARE 

000400 ' COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000500 HALVES FIXED BINARY (31), 

000600 QUARTERS FIXED BINARY (31), 

000700 DIMES FIXED BINARY (31), 

000800 NICKELS FIXED BINARY (31), 

000900 SYSPRINT FILE STREAM OUTPUT PRINT3 

001000 DO HALVES = 100 TO 0 BY -5903 

001100 DO QUARTERS = (100 - HALVES) TO 0 BY -253 

001200 DO DIMES = ((100 - HALVES ~- QUARTERS)/10)*106 TO 0 BY -103 
001300 “NICKELS = 100 - HALVES - QUARTERS - DIMES; 

001400 FUT FILE(SYSPRINT) DATACCOUNT HALVES, QUARTERS ,»DIMES NICKELS ) 3 
001500 COUNT = COUNT + 13 

0016090 END; 

001700 END 3 

001800 END 3 

001900 END COINS; 

HHMI IHNEN I KEIHIN BOTTOM OF DATA 262636363636 36 963696 IE SE IEE IE IESE IEE HEHE ESE IEE EE 





Figure 22. Edit - Data Display 


OF EDIT OPERATIONS 


Under edit, four-way scrolling is available via the Scroll PF 
keys. The FIND and LOCATE commands may also be used to scroll toa 
particular character string or line number. 


To modify one or more lines of data, the user simply moves the 
cursor to the desired location and enters the new information by 
overtyping the existing lines. Several lines may be modified 
before pressing the ENTER key. 


Edit Commands 


Two types of commands are used to control edit operations: 


° Line commands -~- may be entered in the line command field on 
any line by overtyping the number that is displayed in that 
field. 

° Primary commands -~- may be entered in the command input field 


at the top of the screen Cline 2). 


Line commands are used to delete, insert, duplicate, or rearrange 
lines of data, or to shift the contents of a line left or right 
(for indentation changes). 


Single character line commands operate on individual. lines (Ce.g., 
D to delete a line, I to insert a blank line, M to move a line). 
Double character line commands operate on blocks of lines (e.g., 
DD on two different lines to indicate the first and last lines to 
be deleted). In most cases, a number may follow the line command 
to indicate multiple occurrences (e.g., 13 to insert three blank 
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lines). Several line commands as well as data modifications may 
be typed before pressing the ENTER key. 


Note: The SPF editor does not distinguish between "input mode” 
and "edit mode." The I Cinsert) line command is used to add new 
lines, either between existing lines or at the end of the data. 
When an empty is specified for editing, the initial display con- 
tains several inserted lines between the "TOP OF DATA" and "BOTTOM 
OF DATA* message lines (Figure 23). 


Primary commands, entered at the top of the screen, are used to 
control edit modes, locate a specific line, submit data to the job 
stream, find and change character strings, control sequence num- 
bering and character translation, effect segmentation changes 
(splitting a member into two members or merging two members into 
one), save the edited data, or cancel without saving. 


EDIT --- NEWFILE COBOL Al COLUMNS 007 078 
COMMAND INPUT ===> _ SCROLL ===> HALF 
328 HOEE JERE RRO RHEE REE HEOEEEEIE TOP OF DATA 36969636969696369696 3696969696966 969836 IE IEICE IE EIEN IE 
tpeers 


pacenes 
erepes 
steraens 
#eprees 
petoees 
oetreees 
eorete 
eeoauus 
seurue 
eptess 


JBBROEE JRE BREE BOTTOM OF DATA 26369639636369696962630 3096963630969 6 EIEIO 





Figure 23. Edit - Creating New Data 


A new SPF user need not master all the Line commands and primary 
commands to make effective use of edit. The command descriptions 
in this manual are grouped under the following headings: 


° Basic Line Commands - Describes the commands used for identi- 
fying columns, inserting and deleting lines, repeating lines, 
moving and copying lines, and rules for entering line com- 
mands. Should be read by all users. 


° General Commands - Describes the commands used for locating 
lines, sequence number generation and control, statistics 
generation, automatic source listings, recovery control’, gen- 
eral reset, submit to job stream, save and cancel. Should be 
read by all users. 


e Finding and Changing Character Strings ~ Contains a summary 
of the FIND and CHANGE commands, which should be read by all 


users, followed by a detailed description of FIND/CHANGE 
optional parameters and features. 
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Figure 24. 


Advanced Features ~ Describes the commands used for line mask 


definition, 
excluded lines, 


indentation changes, 


segmentation changes, 
definition and control, 
hexadecimal display. 


profile 


boundary column definition, 
nulls control, tabs 
display and control, and 


Text Preparation Features - Describes the commands used for 
character translation, 


lines. 


described, 


DOCUMENT 
SECTION 


COMMANDS 


GENERAL 
COMMANDS 


FIND AND 
CHANGE 


ADVANCED 
FEATURES 


TEXT 
PREPARATION 
FEATURES 


is shown 


cCOLS 
I - 
D- 


< - 
> - 
( “ 
) ~ 


in Figure 24. ar l 
found in Appendix C, and a quick reference summary in Appendix D. 


text entry and edit, and overlaying 


A list of edit commands, and the section under which each is 


A command summary may also be 


EDIT LINE COMMANDS 


INSERT 
DELETE 
REPEAT 


DATA LEFT 
DATA RIGHT 
COLS LEFT 
COLS RIGHT 


TEXT ENTRY 
TEXT SPLIT 
TEXT FLOW 
OVERLAY 


List of Edit Commands 
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COPY 


- AFTER 


BEFORE 


EXCLUDE 
SHOW 
FIRST 
LAST 


EDIT PRIMARY COMMANDS 


LOCATE 
NUMBER 
RENUM 
UNNUM 
AUTONUM 
STATS 


MOVE 
CREATE 
REPLACE 





RECOVERY 
RESET 
SUBMIT 
SAVE 
CANCEL 


TABS 
PROFILE 
HEX 


Edit Modes and Profiles 


Edit is capable of operating in the following modes: 


° NUMBER Mode ~- controls validation and generation of sequence 
numbers. — 


° AUTONUM Mode ~- controls automatic renumbering when the data 
is saved. 


e STATS Mode - controls generation of SPF library statistics. 


° PRINT Mode - controls automatic recording of source listings 
in the SPF list file. 


° CAPS Mode - controls translation of alphabetic characters to 
upper case. 


e NULLS Mode - controls replacement of trailing blanks with 
null characters on the display screen. 


° TABS Mode —- controls use of "hardware" or "logical” tabs. 
° HEX Mode - controls display of data in hexadecimal format. 


° RECOVERY Mode - controls automatic recording of edit trans~- 
actions to facilitate recovery following a system failure. 


Each mode may be turned on or off independently of the other modes 
by means of the following primary commands: NUMBER, AUTONUM, 
STATS, PRINT, CAPS, NULLS, TABS, HEX, and RECOVERY. See the com- 
mand descriptions for further explanation. 


The current settings of the modes, together with the current MASK, 
TABS, and BOUNDS lines, are maintained in an edit profile which 
may be displayed at any time via the PROFILE command. When edit 
is terminated, the current edit profile is automatically saved as 
part of the user profile. 


SPF maintains up to 25 different edit profiles for each user. 
This allows different mode settings and different MASK, TABS, and 
BOUNDS lines to be remembered and used as the initial settings for 
different types of source data. 


Each profile is normally associated with the data "type" Cthe SPF 
library type or CMS filetype). When the user edits COBOL data, for 
example, the default profile contains whatever modes were in 
effect the last time the user finished editing COBOL data. Addi- 
tional profiles may be created and used by specifying a profile 
Bale on the edit entry panel, or as an operand on the PROFILE com- 
mand. 


Listed below are the default mode settings when a new profile is 
generated (i.e., when the user edits a new type of data for the 
first time, or specifies a new profile name on the edit entry pan- 
el). If the user already has 25 edit profiles, the least recently 
be profile is automatically deleted when a new profile is gener- 
ated. 


NUMBER ON 
AUTONUM OFF 


STATS ON 
PRINT OFF 
CAPS ON 
NULLS OFF 
TABS OFF 


HEX OFF 
RECOVERY OFF 
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Three of the mode settings will be automatically changed, if 
appropriate, whenever data is fetched for editing: | 


® NUMBER mode will be set on or off depending upon whether the 
data currently contains sequence numbers. 


@ CAPS mode will be set on or off depending upon whether the 
data currently contains lower case alphabetics. 


° STATS mode will be set on if the member currently has SPF 
statistics. If STATS mode is already on and the member has no 
statistics, a caution message will be displayed but STATS 
mode will be left on. (CSTATS mode is ignored for CMS files.) 


A caution message is displayed whenever edit automatically 
changes one of these mode settings. The message is displayed in 
the first two lines of the data area. An example is shown in 
Figure 25. A caution message is also displayed if edit discovers 
invalid Cnon-displayable) characters in the data. 


Caution messages may be removed from display by using the RESET 

- primary command or by deleting the individual message lines using 
the "D" line command. Caution messages are never saved as part of 
the data. 


EDIT --- SPFDEMO.MYLIB.PLIC(COINS) - 01.04 COLUMNS 001 072 

COMMAND INPUT ===> _ SCROLL ===> HALF 

HHMI HEI IIE ETE HE EEE IEE EEE SE MEE HHHNHNM TOP OF DATA 26S IIE IIE IIE IE HE IEE HEHEHE HE IE HE HEHEHE HEH ENE 
_ &=MSG> -CAUTION- PROFILE CHANGED TO "NUMBER ON STD" (FROM "NUMBER OFF"). 

==MSG> _ DATA HAS VALID STANDARD NUMBERS. 

000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN); 

000300 DECLARE 

000400 COUNT FIXED BINARY €31) AUTOMATIC INIT (13, 

000500 HALVES FIXED BINARY (31); 

000600 QUARTERS FIXED BINARY (31), 

060700 DIMES FIXED BINARY (31), 

000800 NICKELS FIXED BINARY (31), 

000900 ’ SYSPRINT FILE STREAM OUTPUT PRINT3 

001000 DO HALVES = 100 TO 0 BY -50;3 

001100 DO QUARTERS = (100 - HALVES) TO 0 BY -253 

001200 DO DIMES = ((100 - HALVES - QUARTERS)/10)*10 TO 0 BY -103 

001300 NICKELS = 100 - HALVES - QUARTERS - DIMES; 

001400 PUT FILE(SYSPRINT) DATACCOUNT ,» HALVES» QUARTERS, DIMES »NICKELS J 5 

001500 COUNT = COUNT + 13 

001600 END; 

001700 END; 

001800 END; 

601900 END COINS; 

HHMI WHINE IE HEI IE HEME IMME NHHR BOTTOM OF DATA 2 III IE IE IE IE HE IE IE ENE IEE IE HE EE IEE 





Figure 25. Edit - Caution Message 
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Edit Termination. 


Normally, edit is terminated by pressing the End PF key, which 
causes the following actions: 


1. If any changes have been made to the data: 


° The data is renumbered if both NUMBER mode and AUTONUM 
mode are on. 


° The data is automatically saved -- see description of 
SAVE command. 


Note: "Special™ lines (MASK, TABS, COLS, BOUNDS, message 
lines, and profile display lines) are never saved as part 
of the data, and need not be deleted prior to issuing a 
SAVE command or pressing the End PF key. 


° The SPF statistics are updated (Cor generated if none pre- 
viously existed} if STATS mode is on and the data is a 
member of an SPF library. 


° A source listing of the data is recorded in the SPF list 
file for eventual printing if PRINT mode is on. 


2. A return is then made to the previous display Ceither the mem- 
ber selection list or the edit entry panel). When return is 
to the member selection list, the member just edited will 
appear at the top of the list. 


Note: The Return PF key, which is logically equivalent to 
repeated use of the End PF key, will also cause action (1) to 
occur. 


The user may save the data without terminating edit Cand without 


printing) via the SAVE command. The user may also terminate edit- 
ing without saving (Cor printing) via the CANCEL command. 
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BASIC LINE COMMANDS 


The following commands are described in this section: 


COLS Ccolumns) M (move) 

I Cinsert) C Ccopy) 

D (delete) A Cafter) 
R Crepeat) B (before) 


These are all “lLine™ commands, entered by overtyping the 6-digit 
number in the line command area on one or more lines. 


Identifying Columns 


A column identification line may be displayed by entering the 
characters "COLS™ or "COL”™ in the line command area, overtyping 
the line number. 


COLS - Display column identification line . 


Command abbreviation: COL 





When the ENTER key is pressed, a special line is inserted at the 
designated position and the remaining lines are pushed down by one 
line position. An example of the COLS line is shown in Figure 26. 


EDIT --- SPFDEMO.MYLIB.PLI(COINS) - 01.04 COLUMNS 001 072 
‘COMMAND INPUT ===> _ SCROLL ===> HALF 
JERE JER EEE EEE RIE TOP OF DATA 36396963696969636969696969696 909696 96.96 EIEN IEIE HIE EIEIEN 
000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN); 

000300 DECLARE 

000400 COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000500 HALVES FIXED BINARY (31), 

000600 QUARTERS FIXED BINARY (31), 

SCOLS> ---~4- 2 n= ] nn po nn 2 on pn Bae pee ue en few we een pee hen nn te nnn Ja= 
000790 DIMES FIXED BINARY (31), 

000800 NICKELS FIXED BINARY (31), 

0co900 SYSPRINT FILE STREAM OUTPUT PRINT; 

001000 DO HALVES = 100 TO 0 BY -50; 

001100 DO QUARTERS = (100 - HALVES) TO 0 BY -253 

001200 DO DIMES = ((100 ~ HALVES ~ QUARTERS)/10)*10 TO 0 BY ~10; 
001300 NICKELS = 100 - HALVES ~ QUARTERS ~ DIMES; 

001400 PUT FILE(SYSPRINT) DATACCOUNT ,HALVES, QUARTERS »DIMES ,NICKELS )3 
001500 COUNT = COUNT + 13 

001600 

001700 

001800 

001900 END COINS; 

SESE IEE EE IEIEIEIE IE IEIEIEIE IE IEICE IEIEIEIEIEIEIENEIEIEN® BOTTOM OF DATA 363656969656963696969636369696 96363096996 3696263696309 





Figure 26. Edit - Column Identification Line 


Edit (Option 2) 47 


Note: Unlike browse, COLS is a line command, not a primary command 


Cit may not be entered in the command input field on line 2). 


The column identification line may be removed from display by 
entering a "D" in the line command area, or by entering a RESET 
primary command. The column identification line is never saved as 
part of the data. 


Inserting and Deleting Lines 
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To insert a line, the single character "I" is entered in the line 
command area, overtyping the line number. When the ENTER key its 
pressed, a new line is inserted immediately following the line 
containing the "I". A number may follow the "I" to indicate that 
more than one line is to be inserted. For example, "I3" would 
cause three new lines to be inserted. 


I - Insert line 
In = Insert "n™ lines 


If any information is entered on an inserted line Ceven a blank 
character), the line becomes part of the source data and is 
assigned a line number the next time the ENTER key is pressed. If 
no information is entered on an inserted line, the line is auto- 
matically deleted the next time the ENTER key is” pressed. If 
information is entered on the last Cor only) inserted line and if 
the cursor is still in the data portion of that line when ENTER is 
pressed, another new line is automatically inserted following 
that line. This allows line after line of data to be eanereced in 
a "continuous insert" mode. 


To delete a line, the single character "D" is entered in the line 
command area, overtyping the line number. A number may follow the 
"Dp" to indicate that more than one line is to be deleted. For 
example, "D99999" would cause all remaining lines to be deleted, 
starting with the line containing the "D99999", 


D - Delete line 


Dn - Delete "n* lines 
DD - Delete block of lines 





To delete a block of lines, the double character "DD" is entered 
in the line command area of the first and last lines to be 
deleted. The first and last line need not be on the same page; 
SC uanaw may be used between entering the first "DD" and the sec- 
ond "DD", 


Prgure 27 shows a before-and-after example of line insertion and 


deletion. Three new lines are inserted after line 800 and line 
1400 is deleted. 
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EDIT --- SPFDEMO.MYLIB.PLI(COINS) ~ 01.04 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
HHH HII HIKE IE HE IE HHH RKKKHH TOP OF DATA 2656 IEE IEE HE IEE EHIME HEHEHE HIE 
000100 COINS: 
000200 PROCEDURE OPTIONS (MAIN); 
000300 DECLARE — 
000400 . COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 
000500 HALVES FIXED BINARY (31), 
000600 QUARTERS FIXED BINARY (31), 

DIMES FIXED BINARY (31), 

NICKELS FIXED BINARY (31), 

SYSPRINT FILE STREAM OUTPUT PRINT; 

DO HALVES = 100 TO 0 BY -50; 
DO QUARTERS = (100 ~- HALVES) TO 0 BY -25; 
DO DIMES = ((100 - HALVES - QUARTERS)/10)*10 TO 0 BY -103 

001300 NICKELS = 100 - HALVES - QUARTERS - DIMES; 
D_ PUT FILEC(SYSFRINT) DATACCOUNT »HALVES, QUARTERS »DIMES NICKELS); 
001500 COUNT = COUNT + 13 
001600 END; 
001700 END; 
001800 END; 
091590 END COINS; 
HHI IH HI IMEI IEE TE HE IEEE IEIE EIEN BOTTOM OF DATA 2636963363969 IEIE IIE IEIEIE IE IEE IE DE IE HE HEE IE IEE 


EDIT --- SPFDEMO.MYLIB.PLI(COINS) - 01.04 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
SERIE HEISEI IEEE IEEE EI TOP OF DATA 365639696969696969696 969696969696 96 969369 9D IEEE IEEE 
000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN); 

000300 DECLARE 

600400 COUNT FIXED BINARY (31) AUTOMATIC INIT (1); 

900500 HALVES FIXED BINARY (313; 

000600 QUARTERS FIXED BINARY (31), 

000700 DIMES FIXED BINARY (31), 

000800 NICKELS FIXED BINARY (31), 


pauctuaes 


000900 SYSPRINT FILE STREAM OUTPUT PRINT; 

001000 BO HALVES = 100 TO 0 BY -503 

001100 DO QUARTERS = (100 - HALVES) TO 0 BY -253; 

001200 DO DIMES = ((100 - HALVES - QUARTERS)/10)*10 TO 0 BY -103 
001360 NICKELS = 100 - HALVES - QUARTERS - DIMES; 

001500 COUNT = COUNT + 13 

601600 END 5 

001700 END ; 

001800 END; 

001900 END COINS; 

KKH HH HHH HHH HHH HHH KH KH KHKHKKHKHH BOTTOM OF DATA 3363639639696 HE SEITE HEMI HHI HEIN 





Figure 27. Edit - Insert and Delete Lines Example 
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Repeating Lines 
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To repeat a line, the single character "R" is entered in the line 
command area, overtyping the line number. When the ENTER key is 
pressed, a duplicate copy of the line is inserted immediately fol- 
lowing the line containing the "RR". A number may follow the "R" 
to indicate that the line is to be repeated more than one time. 
For example, "R5" would cause five identical copies of the line to 
be inserted. 


Repeat line 
Repeat line "n" times 


Repeat block of lines 
Repeat block of lines "n™ times 





To repeat a block of lines, the double character "RR" is entered 
in the line command area of the first and last lines to be 
repeated. The first and last lines need not be on the same page. 
A number may follow the "RR" on either the first or last lines (or 
both) to indicate that the block of lines is to be repeated more 
than one time. ; 


Suppose, for example, the following code is to be generated: 


DECLARE 
I FIXED BINARYC31), 7* WORK COUNTER 7 
J FIXED BINARY(31), 7* WORK COUNTER X/ 
K FIXED BINARYC(31), 7% WORK COUNTER X/ 
L FIXED BINARY(31); 7% WORK COUNTER 7 


The easiest way to generate this code is to type the first two 

lines, repeat the second line three times, then move the cursor to 

each of the repeated lines and make the necessary changes. A 

oot one erser illustration of the repeat command is shown in 
igure < 
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EDIT --- SPFDEMO.MYLIB.PLI(DCLS) - 01.00 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
HHI MEIC IE TENE HEINE HEE HEHE NEE EIEN HEE IEENIEMNNHN TOP OF DATA 2262656969636 III IE HE HIE NE HEHE HEINE EIEN HEHEHE 
000100 /* SEGMENT "DCLS' -- INCLUDED FROM SEGMENT 'MAIN' */ 
DECLARE 
I FIXED BINARY(31), 7* WORK COUNTER */ 
DECLARE 
COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 
HALVES FIXED BINARY (31), 
QUARTERS FIXED BINARY (31); 
DIMES FIXED BINARY (31), 
NICKELS FIXED BINARY (31), 
SYSFRINT FILE STREAM OUTFUT PRINT; 
DO HALVES = 100 TO 0 BY -50; 
DO QUARTERS = (100 - HALVES) TO 0 BY -253 
DO DIMES = ((100 - HALVES - QUARTERS)/10)*10 TO 0 BY -10; 
NICKELS = 100 - HALVES - QUARTERS - DIMES; 
PUT FILE(SYSPRINT) DATA(COUNT>,HALVES, QUARTERS» DIMES, NICKELS )3 
COUNT = COUNT + 1; 
END; 
END; 
END ; 
END COINS; 
HIN MITE IE IE IE HE TEE HEE IEE HEHE IEE MMII BOTTOM OF DATA 3€36963636969696 96969696 5 IE HE IEE IEE IE IEE IE IEE HE IED 


EDIT --- SPFDEMO.MYLIB.PLI(DCLS) - 061.00 COLUMNS 001 072 
COMMAND INPUT === SCROLL ===> HALF 
HEIN HEME IEE IE IE IEE IE HE 3E IE IE IE IE IE SEER IEE IEIEIEIEM TOP OF DATA 3€36963636963696 969696 96 3696 IE DE FE SE IEE IE IE DE IE IE IE TE IESE IEEE 
000100 /* SEGMENT 'DCLS' -- INCLUDED FROM SEGMENT ‘MAIN’ %/ 
000200 DECLARE 

000300 I FIXED BINARY(31); 7* WORK COUNTER */ 
000310 I FIXED BINARY(31)}> 7% WORK COUNTER %/ 
000320 I FIXED BINARY(31)>5 7* WORK COUNTER */ 
000330 I FIXED BINARY(C31), 7% WORK COUNTER */ 
000400 DECLARE 

000500 COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000600 HALVES FIXED BINARY (31), 

000700 QUARTERS FIXED BINARY (31), 

000800 DIMES FIXED BINARY (31), 

000900 NICKELS FIXED BINARY (31), 

001000 SYSPRINT FILE STREAM OUTPUT PRINT; 

001100 DO HALVES = 100 TO O BY -50;3 

001200 DO QUARTERS = (100 - HALVES) TO 0 BY -25;3 

001300 DO DIMES = ((100 ~- HALVES - QUARTERS)/10)*10 TO 0 BY -103 
001400 NICKELS = 100 ~ HALVES - QUARTERS - DIMES; 

001500 PUT FILE(SYSPRINT) DATA( COUNT, HALVES, QUARTERS, DIMES, NICKELS )3 
001600 COUNT = COUNT + 13 

001700 END; 

001800 END; 

001900 END 

002000 END COINS; ; 

HHI HHH IIH HEHE HIE HEHEHE IH IMH HNN BOTTOM OF DATA 2363363636 IEIE IE HEE IIE IE IE HEE HEE IE IEEE 





Figure 28. Edit - Repeat Line Example 
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Moving and Copying Lines 


To move a line, the single character "M" is entered in the line 
command area of the Line to be moved, and the character "A" Caf- 
ter) is entered in the line command area of another line, indicat- 
ing the destination of the move. When the ENTER key is pressed, 
the Line containing the "M" is moved immediately following the 
line containing the "A". Alternatively, the destination may be 
indicated with a "B" (before) line command, in which case the line 
containing the "M" jis inserted immediately preceding the line 
containing the "B". 


line 
"nh" lines 
block of lines 


line 
"nh" lines 
block of lines 


After this line 

After this line and repeat "n" times 
Before this line 

Before this line and repeat "n" times 





A number may follow the "M" to indicate that more than one line is 
to be moved. A block of lines to be moved is indicated by enter- 
ing the double character "MM" on the first and last lines to be 
moved. The first and last lines to be moved, and the destination 
line may all be on separate pages. 


A number may also follow the "A™ or "B" Line command to cause the 


moved line €s) to be repeated the designated number of times at the 


point of destination. 


The procedure for copying lines is the same as for moving lines, 
except that a "C" or "CC" line command is used in place of the "M" 
or "MM". The copy operation leaves the original line(s) in place, 
and makes a duplicate copy at the indicated destination. 


Figure 29 shows a before-and-after example of copying lines. The 
block of lines starting at line 800 through line 1500 is copied to 
follow line 1900. 
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EDIT --- SPFDEMO.MYLIB.PLI(TESTDIR) - 01.03 COLUMNS 001 072 
CONMAND INPUT ===> SCROLL ===> HALF 
IF ERROR-FLAG THEN 
DO; 
PUT FILECSYSPRINT) 
EDIT(C' TEST NOTES ERROR RETURN FROM D-I-R') 
(COLUMN(21),A034) )3 
PUT FILE(SYSPRINT) SKIP(2) 
DATACERROR-FLAG » CARD-IMAGE » ANSWER ) 3 
ERROR-FLAG = '0'B; 
END; 
ELSE 


* 
> 


001800 END; 
A. ELSE 
002000 ; 

002100 END; 

002200 END TESTDIR; 

HII IIH IE IE IEE HEHE ENE ESE EMH HI HHHMH BOTTOM OF DATA 3363636963696 9696 969 IESE IE IE TENE IE ETE IE EEE ENE IEEE 


EDIT --- SPFDEMO.MYLIB.PLI(TESTDIR) - 01.03 COLUMNS 001 072 
CONMAND INPUT ===> . SCROLL ===> HALF 
000700 IF ERROR-FLAG THEN 

000800 DO; 

000900 PUT FILE(SYSPRINT) 

001000 EDIT(''TEST NOTES ERROR RETURN FROM D-I-R') 

001100 (COLUMN(21),A(34))3 

001200 PUT FILE(SYSPRINT) SKIP(2) 

001300 DATACERROR-FLAG, CARD-IMAGE »ANSHER ) 3 

001400 ERROR-FLAG = '0'B; 

001500 END; 

001600 ELSE 

001700 . ; 

001800 END; 

001900 ELSE 

001910 DO; 

001920 PUT FILE(SYSPRINT) 

001930 EDIT('TEST NOTES ERROR RETURN FROM D-I-R') 

001940 (COLUMN( 21) A034) )3 

001950 PUT FILE(SYSPRINT) SKIP(2) - 

001960 DATA( ERROR-F LAG» CARD-IMAGE » ANSWER ) 

001970 ERROR-FLAG = '0'B; 

001980 END; 

002000 | ; 

002100 END; 

002200 END TESTOIR; 

FHI IIH HIE EEE IE EEE IEE HEE EI IMIEHHMHWE BOTTOM OF DATA 25633656 EE EE TE TE IE IE HE IE IE HE ETE ENE TE 





Figure 29. Edit ~ Copy Lines Example 
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Rules for Entering Line Commands 
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The following rules apply to all edit line commands. 


Several line commands as well as data modifications may be typed 


before pressing the ENTER key. Error messages will be displayed 
in cases where multiple line commands are ambiguous. If an erro- 
neous or unwanted line command is entered, it may be undone by 
simply blanking it out or by using the RESET primary command. 


In most cases, only the first one or two characters of the line 
number need be overtyped to enter a line command. For example, if 
line 700 is to be repeated, a single "R" may be typed: 


000600 
ROO700 
000800 


In some cases, however, typing a single character may be ambig~- 
uous. In the following example, it is unélear whether the user 
has typed a single "R" to repeat line 31700, or "R3" to repeat the 
line three times. 


031600 

R31700 

031800 
In such cases, edit assumes that the user has not entered a number 
following the line command. If the user meant to repeat the line 
three times, he may use any of the following procedures. 


1. Leave the cursor on the character immediately following the 
WR3": R31700 


2. Type one or more blanks following the "R3": R3 700 


3. Type one or more blanks following the "R"™ but before the > 
number: R 3700 


4. Type "R3" and then press the ERASE EOF key to clear the rest 
of the line command field, or press ERASE EOF first and then 
type Wea ; 

Three line commands may be entered on the "TOP OF DATA" line by 

overtyping the asterisks which normally appear in its line com- 

mand field. They are: 

I or In ~ to insert lines ahead of the rest of the data. 

Aor An ~ to move or copy lines ahead of the rest of the data. 

TE or TEn - to enter text lines ahead of the rest of the data. 


One line command may be entered on the "BOTTOM OF DATA” line by 
overtyping the asterisks, namely: 


B or Bn ~ to move or copy lines following the rest of the data. 


Hints on use of cursor keys: Use the NEW LINE key to move the cur- 


sor to the line command area of the next line. If the cursor is in 


a line command area, use the TAB FORWARD key to space over to the 
data field. 


Note: bihen a line conmand or data modification is. typed and the 
ENTER key is pressed, edit will frequently reposition the cursor 
to another line number or to another location within the data. 

Edit attempts to guess the most appropriate position for the cur- 
sor, based on the previous user action. To assist the user in 





locating the cursor, edit intensifies the line number field on the 


line that contains the cursor. 
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GENERAL COMMANDS 


The following commands are described in this section: 


LOCATE AUTONUM RESET 
NUMBER STATS SUBMIT 
RENUM PRINT SAVE 
UNNUM RECOVERY CANCEL 


These are all "primary" commands, entered in the command input 
field on line 2. 


Locating Lines 


The LOCATE command performs up or down scrolling, as required, to 
a specified line number. If the specified line is not found, 
scrolling is to the line which precedes the specified line number. 
Format: ay 95 


LOCATE line-number 


Command abbreviations: LOC, L 





The "line-number™ operand is a numeric value of up to 8 digits 
(leading zeros need not be typed). If the operand contains 6 or 
fewer digits, it refers to the numbers in the line command fields, 
displayed at the left of each line. (For numbered data, these 
fields reflect the sequence numbers in the data records. For 
unnumbered data, these fields show relative line numbers.) If the 
line-number operand contains 8 digits, it refers directly to the 
sequence numbers in the data records, including the "modification 
flag" for SPF libraries (see below). 


Sequence Number Generation and Control 


When operating in NUMBER mode, edit automatically generates 
sequence numbers in the data for new lines that are created by 
insert or copy operations, and automatically renumbers the data 
when it is saved (provided AUTONUM mode is also in effect). 


Sequence Number Format 


Sequence numbers may be generated in the "standard" sequence 
field, the COBOL sequence field, or both. The standard sequence 
field is either the last 8 characters of the data (Cfor fixed 
length records) or the first 8 characters of the data (for vari- 
able length records), regardless of the programming language. 
The COBOL sequence field is always the first 6 characters of the 
data, and is valid only for fixed length records. 


For members. of partitioned data sets, the format of standard 
sequence numbers is dependent on whether SPF statistics are being 
generated. If STATS mode is in effect, standard sequence numbers 
are 6 digits in length, followed by a 2-digit modification flag. 
The flag reflects the modification level of the member when the 
-line was created or last changed. If, for example, a sequence 
number field contains 00040002, the Line was added or last changed 
at modification level 02. The sequence number is 000400. When a 
new member is created with SPF statistics, the flags are all set 
to 00, since the modification level is initialized to zero. 
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If STATS mode is off, or if a is being edited, standard sequence 
numbers are 8 digits in length Cright justified within the field). 
COBOL sequence numbers are always 6 digits in length, and are 
unaffected by the setting of STATS mode. 


Sequence numbers normally start at 100 and are incremented by 100. 
When inserting lines, edit will drop down to the tens or units 
position and, if necessary, renumber one or more succeeding lines 
to keep the sequence numbers in order. 


Sequence Number Display 


For numbered data, the edit line command fields (displayed at the 
left of each line) reflect the contents of the sequence numbers in 
the data. Normally the sequence numbers themselves are not dis-~ 
played, but the user may view them via left or right scrolling. 


The user may increase the width of the edit "window" to include 
the sequence numbers via the DISPLAY operand on the NUMBER or 
RENUM command. The difference will be noticeable only if the width 
of the data is less than the available width of the screen. 


Example: 


Suppose the data to be edited is fixed format, logical record 
length 100. It has both COBOL sequence numbers in the first 6 
columns, and standard sequence numbers in the last 8 columns. 
The data width, excluding sequence numbers, is thus 86 char- 
acters Cin columns 7 through 32). 


On a 3278 Model 5, which has an available screen width of 132, 
the default format is as follows: Each line will start with 
the 6-character line command field, followed by a data window 
that is 86 characters wide. Remaining positions beyond the 
window will be protected and blank. 


Upon initial display, columns 7-92 of the data will be shown 
in the 86~-character window. The sequence numbers in the data 
will not be displayed. The user may display the numbers via a 
left or right scroll, but the window will remain 86 characters 
wide. If the user enters a NUMBER or RENUM command with the 
DISPLAY operand, the width of the Window will be changed to 
100 characters, and the sequence numbers in the data will be 
displayed. 


Initialization of NUMBER Mode 
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As data is fetched for editing, it is examined to determine 
whether or not it contains sequence numbers. The standard 
sequence field is always examined. The COBOL sequence field is 
also examined if the data set "type" Clowest level qualifier in 
the data set name) is COBOL. 


If all lines contain numeric characters in either the standard or 
COBOL sequence field positions (or both), and if the numbers are 
in ascending order, edit assumes the data is numbered and turns on 
NUMBER mode. Otherwise, edit turns off NUMBER mode. 


If the initial setting of NUMBER mode differs from the previous 
setting in the profile, a message will be displayed indicating 
that edit has changed the mode. For new members or empty sequen- 
tial data sets, the initial setting of NUMBER mode is unchanged 
from whatever is specified in the profile. The default for a new 
profile is NUMBER mode ON for standard sequence fields, and for 
COBOL fields if the data set type is COBOL. 
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Controlling Sequence Numbering 


ee mode may be turned on or off by using the NUMBER command. 
ormat: 










NUMBER [ON/OFFJ [CSTD] [COBOL] [DISPLAY] 


Command abbreviation: NUM 
Keyword abbreviation: COB (for COBOL) 


The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. The STD, COBOL, and DISPLAY operands 
are interpreted only when NUMBER mode is turned on. 





If STD is specified, the data will be numbered in the standard 
sequence field. If COBOL is specified, the data will be numbered 
in the COBOL field. If both STD and COBOL are specified, the data 
will be numbered in both fields. If both operands are omitted, 
the default is STD unless NUMBER mode was already in effect, in 
which case the data will be numbered in whichever field(s) were 
previously being numbered. 


Note: If both STD and COBOL numbers are being generated, the STD 
number is determined and then used as the COBOL number. This can 
result in COBOL numbers which are out of sequence if the COBOL and 
STD fields are not synchronized. Use the RENUM command (see 
below) to force synchronization. 


If the DISPLAY operand is specified, the width of the data window 
will include the sequence number fields (sea "Sequence Number 
Display"). Otherwise, the width of the window will exclude the 
sequence number fields. 


When NUMBER mode is turned on, the NUMBER command verifies that 
all lines have valid numbers that are in ascending sequence. It 
renumbers any lines that are either unnumbered or out of sequence, 
but does not otherwise alter existing sequence numbers. 


Three additional commands, RENUM, UNNUM, and AUTONUM, are avail- 
able to assist with number generation and control. 


The RENUM command immediately renumbers all lines, starting with 
number 100 and incrementing by 100, and also turns on NUMBER mode. 
Format: 


RENUM [CSTD] [COBOL] [DISPLAY] 


Command abbreviation: REN 
Keyword abbreviation: COB (for COBOL) 





The meaning of the STD, COBOL, and DISPLAY operands is the same as 
for the NUMBER command. 


The UNNUM command sets all sequence fields to blanks and also 
turns off NUMBER mode. It is valid only when NUMBER mode is cur- 
rently on. The fields to be blanked are either the standard 
sequence field, the COBOL sequence field, or both, depending what 

o rata being numbered prior to issuing the UNNUM command. 
ormat: 


UNNUM 
Command abbreviation: UNN 


The UNNUM command uses no operands. 
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The AUTONUM command controls the setting of AUTONUM mode. When 
this mode is on, the data is automatically renumbered whenever it 
is saved, provided NUMBER mode is also on at that time. 


AUTONUM mode may be turned on or off. by using the AUTONUM Comaana: 


Format: 


AUTONUM. [ON/OFF] . 


If the operand is omitted, ON is the default. 


Statistics Generation 


Generation of SPF statistics for a member of a partitioned data 
set is controlled by STATS mode. If STATS mode is on when the 
member is saved, the statistics will be updated Cor created if the 
member did not previously have statistics) and stored in the "us- 
er™ portion of the directory entry for that member. If STATS mode 
is off when the member is saved, no statistics are stored and any 
previous statistics are destroyed: STATS mode is ignored for 
sequential data sets. 


STATS mode may be turned on or off by using the STATS command. 
Format: 


STATS CON/OFF] 


If the operand is omitted, ON is the default. 


Whenever a member is fetched for editing, SPF will check the set- 
ting of STATS mode. If STATS mode is off and the member has sta- 
tistics, SPF will automatically turn on STATS mode and display a 
message indicating that the mode has been changed. If STATS mode 
is on and the member has no statistics, a warning message will be 
displayed but the mode will remain unchanged. 


When a new member is created, the initial setting of STATS mode is 
unchanged from whatever is in the profile. The default for a new 
profile is STATS mode ON. 


The generation of SPF statistics also affects the format of 
sequence numbers, as discussed under "Sequence Number Generation 
and Control”. 


Automatic Source Listings 
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The automatic generation of source listings is controlled by 
PRINT mode. If this mode is on when edit is terminated via the End 
or Return PF key, and if the data has been changed, a source list- 
ing of the data will be recorded in the SPF list data set for 
eventual printing. 


PRINT mode may be turned on or off by using the PRINT command. 
Format: 


PRINT CON/OFF] | 


If the operand is omitted, ON is the default. 
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Recovery Control 


When edit is operating in RECOVERY mode, an audit trail of user 
interactions is automatically recorded in an SPF-controlled data 
set. Following a system failure, the recovery data set may be used 
to replay the edit session. When edit is selected from the prima- 
ry option menu, a special menu is displayed indicating that recov- 
ery is available (Figure 30}. As directed on the menu, the user 
may proceed with recovery, cancel recovery, or press the End PF 
key to return to the primary option menu. 


RECOVERY mode may be turned on or off by using the RECOVERY com- 
mand. Format: 


RECOVERY (CON/OFF] 


Command abbreviation: REC 





If the operand is omitted, ON is the default. 


Operating with RECOVERY mode off may result in improved response 
time due to the elimination of I/0 operations to maintain the 
recovery data set. If RECOVERY mode is on, the first change to 
the data causes a checkpoint of the data to be written. This may 
increase response time for the interaction, especially if a large 
member or sequential data set is being edited. 


EDIT - RECOVERY 
SELECT OPTION ===> _ 


HEHEHE HEHEHE HEHEHE IEIE EH HEE IEIE HE IESE IESE IESE HEHEHE IE HEHEHE IE 
* EDIT AUTOMATIC RECOVERY * 
HHH HHI HHH HH HIE HEH HIE KHER HEHEHE HEE HHI 


SPFDENO.XXX.COBOL(CBLMAIN) 
WAS BEING EDITED WHEN A SYSTEM FAILURE OR SPF ABEND OCCURRED. 


INSTRUCTIONS: 
PRESS ENTER TO CONTINUE THE EDIT SESSION, OR 
PRESS END KEY TO RETURN TO THE PRIMARY OPTION MENU, OR 


ENTER CANCEL ABOVE TO CANCEL RECOVERY OF THE EDIT 
SESSION AND PROCEED TO THE EDIT ENTRY PANEL. 


IF YOU WISH TO PRESS ENTER AND THE MINIDISK IS PASSWORD PROTECTED, SPECIFY: 
READ PASSWORD === UPDATE PASSRORD ===> 


Figure 30. Edit - Recovery Menu 
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General Reset 


Edit will display warning messages in the data portion of the dis- 
play if a mode setting has been automatically changed by edit 
after examination of the data, or if the data contains invalid 
characters. Edit also displays line messages to show the current 
setting of edit modes (when the PROFILE command is entered). Dis- 
play of messages and other special conditions may be reset by 
using the RESET command. Format: 


RESET 


Command abbreviation: RES 





No operands are used for this command. 


The RESET command will: terminate display of all message lines 
and other special lines (COLS, MASK, TABS, and BOUNDS), reset line 
numbers to normal after they were replaced with "==CHG>" or. 
W==ERR>" messages (see CHANGE and shift commands), blank out 
erroneous or unwanted line commands, and redisplay all excluded 
lines. The RESET command does not change any of the edit modes, 
nor alter the data. 


Note: RESET scans every line of data for conditions to be reset. 
Use of the "D" line command to delete one or more special lines 
may result in faster response time. 


Submit to Job Stream 


The SUBMIT command may be used to submit the data being edited 
Cantire member or file) to the job stream of another VM machine. 
Format: 


SUBMIT machine-id 


Command abbreviation: SUB 





The operand is required to specify the VM machine to which the 
data is being submitted. It may specify a CMS batch machine, ora 
VS or DOS machine. 


Note: SPF does not supply a job statement when the edit SUBMIT 
command is invoked. The user may supply job statement(s) as part 
of the data being submitted. 


Save and Cancel 
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The SAVE command may be used to save the edited data without ter- 
minating edit, and the CANCEL command may be used to terminate 
edit without saving the data. Formats: 


SAVE . 


CANCEL 


Command abbreviation: CAN 





No operands are used for these commands. 
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No Note: As a general rule, use of the SAVE command is not necessary 
if RECOVERY mode is on. 


The SAVE command writes the data back to the same data set from 
where it was fetched, except when a concatenated sequence of par- 
titioned data sets has been specified. In this case, the data is 
saved in the first library of the concatenation sequence regard- 
less of which library it came from. For a sequential data set, 
the entire data set is rewritten. For a partitioned data set, the 
member is rewritten with the same member name, and the library 
statistics for the member are automatically updated (provided 
STATS mode is in effect) 


The data is automatically renumbered prior to saving, provided 
both NUMBER mode and AUTONUM mode are in effect 


If SAVE cannot successfully rewrite the data due to I/0 errors or 
insufficient space in the data set, a massage is displayed in the 
upper right-hand corner of the screen, accompanied by an audible 
alarm Cif installed). The user may then attempt to save the data 
in another data set by taking the following steps: 


1. Enter a CREATE or REPLACE command with no operand on the pri- 
mary command line. (CREATE may be used only if the destina~ 
tion 1s a partitioned data set.) 


2. Enter "C99999" or "M99999" on the first data line, indicating 
that all lines are to be copied or moved. Then press the 
ENTER key. 


3. Fill in the data set Cand member) name on the CREATE or 
REPLACE menu, and press the ENTER key. 


See CREATE and REPLACE commands for further information. 


Alternatively, the user may wish to enter split screen mode and 
attempt to fix the problem by using appropriate utilities, e.g., 
compress (for a partitioned data set) or delete and reallocate 
(for a sequential data set), and then retry the save from the edit 
screen. 


The normal way to terminate edit is by pressing the End or Return 
PF key, which causes the following actions. 


1. A SAVE is issued if any changes have been made since the data 
was last saved. (The above discussion of I/0 errors also per- 
tains to an automatic SAVE when the End or Return key i5 
pressed.) 


2. If any saves have occurred, the data is recorded in the SPF 
list data set (provided PRINT mode is in effect). 


3. Editing is then terminated. 


Note: Neither the SAVE nor CANCEL command causes automatic 


recording in the SPF list data set, regardless of the setting of 
PRINT mode. 
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FINDING AND CHANGING CHARACTER STRINGS 


The following commands are described in this section: 


FIND 
CHANGE 


These are both "primary" commands, entered in the command input 
field on line 2. 


The FIND command is used to find one or more occurrances of a 
specified character string, and the CHANGE command is used to 
change one or more occurrences to another character string. Both 


commands allow special forms of character strings and several — 


optional parameters to control: 


e Starting point and direction of search 
° Special conditions to control character string "match" 
° Range and column limitations on extent of search 


The command summary, which follows, describes the basic forms of 
FIND and CHANGE which are most frequently needed. The remainder 
of this section provides detailed information about the various 
special features and options. 


Command Summary 
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The basic format for FIND and CHANGE is: 







FIND string-1 CALL] 


Command abbreviation: F 


CHANGE string-1 string-2 CALL] | | 
Command abbreviations: CHG, C 






The operands may be separated by blanks or commas. The ALL oper~ 
and is optional, and may precede or follow either string. 


As a general rule, the strings are typed without delimiters. 
Examples: 


FIND XYZ 
CHANGE ALL ABC IJKL 


to find the next occurrence of XYZ or to change all occurrences of 
ABC to IJKL. 


Strings may be delimited with either apostrophes (') or quotation 
marks ("). Delimiters must be used if a string contains imbedded 
oe or commas, or if a string is the same as a command keyword. 
Examples: 


FIND 'EVERY ONE! 
CHANGE ‘EVERY ONE’ ‘ALL®* 


to find the next occurrence of "EVERY ONE" or to change the next 
occurrence of "EVERY ONE" to "ALL". 
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If the ALL operand is omitted, the FIND or CHANGE command searches 
for the next occurrence of string-1 starting at the current cursor 
location. (CIf the cursor is not in the data area of the screen, 
scanning starts at the beginning of the first line which is cur- 
rently being displayed.) Scrolling is performed, if necessary, 
to bring the string into view. The cursor is positioned under the 
string (for a CHANGE command, it is positioned at the end of the 
changed string) and a verification message is displayed in the 
upper right-hand corner of the screen. The Find or Change PF key 
ney 2S used to find or change each successive occurrence of the 
string. 


If the string is not found between the current cursor location and 
the end of data, a "BOTTOM OF DATA REACHED" message is displayed 
and the audible alarm is sounded Cif installed). The Find or 
Change PF key may then be used to wrap to the top of data and con- 
tinue searching. If the string is not found anywhere in the data 
a "NO xxxxx FOUND" message is displayed. 


If the ALL operand is typed, the FIND or CHANGE command searches 
for all occurrences of string-1 starting at the top of the data, 
and positions the cursor under the first occurrence. The verifi- 
cation message indicates the number of occurrences found. For a 
CHANGE command, each Line on which a change occurred is indicated 
with a "==CHG>" message in the line number field. 


If the two strings specified for a CHANGE command are not the same 

length, automatic shifting is performed by expanding or collaps- 

ing multiple blank characters to the right of the substitution. 

In no case is data lost. If insufficient blanks exist for 

right-shifting, the original string remains unchanged. This con- 

ee is indicated with a "==ERR>" message in the line number 
ield. 


Following a CHANGE command, the ==CHG> and ==ERR> line messages 
may be reset to normal via the RESET command, or by overtyping the 
line number or data on those lines. 


The Find and Change PF keys may be used together to find each 
occurrence of a character string, examine it, and then either 
change it (by pressing the Change PF key), or go on to the next 
occurrence (by pressing the Find PF key). To do this, start by 
typing a CHANGE command on line 2 but then, rather than pressing 
ENTER, press the Find PF key. This will position the cursor to 
string-1 without changing it. Then press Change (to change it to 
string-2) or Find (to get to the next occurrence of string-1). 


Figure 31 shows a before-and-after example of the CHANGE comand. 
All occurrences of the character string NUMERIC are replaced with 
the string NUMERIC-INT. The cursor is repositioned to the end of 
the first occurrence, and a ==CHG> message is displayed at the 
beginning of each changed line. 
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EDIT --~ CBLMAIN COBOL Al COLUMNS 007 078 
CONMAND INPUT ===> CHG NUMERIC NUMERIC-INT ALL_ SCROLL ===> HALF 
003300 DATA RECORD IS O0-C. 

003400 O01 O-C. 

003500 02 DUMMY PICTURE X(80). 

003600 WORKING-STORAGE SECTION. 

003700 OP-SUB PICTURE S99 COMPUTATIONAL VALUE 0. 
003800 PREV-DEVICE-TYPE-CODE PICTURE X VALUE 'I'. 
003900 PREV-ACTV-CODE PICTURE 9 VALUE 0. 

004000 PREV-PROB-CODE PICTURE 9 VALUE 0. 

004100 C~SWITCH PICTURE X VALUE ‘0’. 

004200 PREV-SYSTEM-CODE PICTURE x VALUE SPACE. 

094300 GSA-REF PICTURE XX. 

004400 UNIT-PRICE-NUMERIC PICTURE S9(8)V99. 

004500 BML-NUNERIC PICTURE $9(8)V99. 

004600 PREV-MODEL PICTURE X(5) VALUE 'O'. 

004700 PG-COUNT PICTURE 999 VALUE 0. 

004800 PERIOD PICTURE 99 VALUE 0. 

004900 PL-TOTAL-PRICE-NUMERIC PICTURE $9(8)V99 VALUE 0. 
005000 PL-TOTAL-BMR~NUMERIC PICTURE S$9(8)V99 VALUE 0. 
005100 PL-MAINT~REQ-NUM PICTURE S9(4)V99 VALUE 0. 

005300 -HEADING-SW PICTURE 9 VALUE 1. 

005400 PREV-DEVICE PICTURE X(6) VALUE SPACES. 

005500 PREV-RPQ-FEATURE PICTURE X(10) VALUE SPACES. 

005600 TENP-MAINT PICTURE S9(7)V99 VALUE 0. 

005700 TOTAL-BMR PICTURE S9(8)V99 VALUE 0. 

005800 TOTL-PR PICTURE S9(8)V99 VALUE 0. 

005900 TOTAL-MAINT PICTURE S9(7)V99 VALUE 0. 


EDIT --- CBLMAIN COBOL Al : CHARS 'NUMERIC' CHANGED 
COMMAND INPUT === SCROLL ===> HALF 
003300 DATA RECORD IS 0-C. 

003400 O01 O-C. 

003500 02 DUMMY PICTURE X(80). 

003600 WORKING-STORAGE SECTION. 

003700 OP-SUB PICTURE S99 COMPUTATIONAL VALUE 0. 
003800 PREV-DEVICE-TYPE~-CODE PICTURE X VALUE ‘I’. 

003500 PREV-ACTV-CODE PICTURE 9 VALUE 0. 

004000 PREV-PROB-CODE PICTURE 9 VALUE 0. 

004100 C~SWITCH PICTURE X VALUE 'O'. 

004200 PREV-SYSTEM-CODE PICTURE X VALUE SPACE. 

004300 GSA-REF PICTURE XX. 

==CHG> UNIT-PRICE-NUNERIC-INT_PICTURE S9(8)V99. 

==CHG> BML-NUMERIC-INT PICTURE S9(8)V99. 

004600 PREV-NODEL PICTURE X(5) VALUE 'O'. 

004700 FPG-COUNT PICTURE 999 VALUE 0. 

004600 PERIOD PICTURE 99 VALUE 0. 

==CHG> PL~TOTAL-PRICE-NUMERIC~-INT PICTURE S9(8)V99 VALUE 0. 
==CHG> PL~-TOTAL-BMR-NUMERIC-INT PICTURE S$9(8)V99 VALUE 0. 
005100 PL~MAINT-REQ-NUM PICTURE $9(4)V99 VALUE 0. 

005300 HEADING~-SW PICTURE 9 VALUE 1. 

005400 PREV-DEVICE PICTURE X(6) VALUE SPACES. 

005500 PREV-RPQ-FEATURE PICTURE X(10) VALUE SPACES. 

005600 TEMP-MAINT _ PICTURE S9(7)V99 VALUE 0. 

005700 TOTAL-BNR PICTURE S9(83V99 VALUE 0. 

005800 TOTL-PR PICTURE $9(8)V99 VALUE 0. 

005900 77. TOTAL~MAINT PICTURE S9(7)V99 VALUE 0. 





Figure 31. Edit - CHANGE ALL Command Example 
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Detailed Command Description 


The complete formats for FIND and CHANGE, showing all optional 
parameters, are as follows: 


FIND string-1 [CNEXT/ALL/FIRST/LAST/PREV] 
CCHARS/PREFIX/SUFFIX/WORD] 
LX/NX] 
Ccol-1 [E€col-2]] 


Command abbreviation: F 
Keyword abbreviations: PRE (for PREFIX), SUF (for SUFFIX) 


CHANGE string-1 string-2 ([NEXT/ALL/FIRST/LAST/PREV] 
[CHARS/PREFIX/SUFFIX/WORD] 
[X/NX] 
{col-1 [col-2]] 


Command abbreviations: CHG, C 
Keyword abbreviations: PRE (for PREFIX), SUF (for SUFFIX) 





Note that FIND under edit has the same format as FIND under 
browse, except for the optional X/NX parameter. 


The operands may be separated with blanks or commas, and may be 
typed in any order except that string-2 (for CHANGE) must follow 
string-1l, and col-2 Cif typed) must follow col-1l. The string-1 
ibd teil is required Cand string-2 for CHANGE); the others are 
optional. 


The "string-1" operand specifies the string to be found. It may 
be specified in any one of the following forms: 


° Any string of characters not starting or ending with an apos~- 
trophe or quotation mark, and not containing any imbedded 
blanks or commas. 


e A delimited string: <Any string starting and ending with an 
apostrophe (') but not containing imbedded apostrophes, or 
starting and ending with a quotation mark (") but not contain-~ 
ing imbedded quotation marks. 


° A hex string: Any delimited string of valid hexadecimal char- 
acters, preceded or followed with the character X. Example: 
X'C27B! 


° A text string: Any delimited string of characters, preceded 
or followed with the character T. See discussion under "Use 
of Text Strings.” Example: T'conditions for' 


e A picture string: <Any delimited string of picture charac- 
ters, preceded or followed with the character P. See dis- 
cussion under "Use of Picture Strings." Example: P*‘.' 


° A single asterisk (*%). This causes the previous value that 
was used as string-1 in either a FIND or CHANGE command to be 
used again. 


The "string-2" operand is required for the CHANGE command to spec- 
ify the new value of the string. The rules for coding string-2 


@re the same as for string-1, except as follows: 


1. A&A text or picture string may not be specified for string-2.. 


2. If a single asterisk is typed, the previous value of string-2 
that was used in a CHANGE command is used again. 
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The previous value of a character string (referenced via * or used 
by the Find/Change PF keys) is retained until the edit option is 
terminated Ci.e., until return to the primary option menu). 


Starting Point and Direction of Search 


The starting point, direction and extent of the search may be 
controlled by one of the following operands. 


NEXT Scan starts at the current cursor location and proceeds 
forwards to find the next occurrence of string-1l. 


ALL Scan starts at the top of data and proceeds forwards to 
find all occurrences of string-l. 


FIRST Scan seats at the top of data and proceeds Teoruerds to 


find the first occurrence of string-l. 


LAST Scan starts at the bottom of data and proceeds backwards to 
: find the last occurrence of string-1l 


PREV Scan starts at the current cursor location and proceeds 
backwards to find the previous occurrence of string-1. 


If this operand is omitted, the default is NEXT. 


If the direction of the search is forward Ci.e, if FIRST, ALL, or 
NEXT was specified), pressing the Find or Change PF key finds or 
changes the next occurrence of the designated string. If the 
direction of the search is backward Cif LAST or PREV was speci-~ 
fied), pressing these PF keys finds or changes the previous occur- 
rence of the string. The other optional parameters CCHARS, WORD, 
PREFIX, SUFFIX, X, NX, and col-1, col-2) remain in effect, as 
specified in the last FIND or CHANGE command. 


The search proceeds until one or all occurrences of string-l are 
found, or until the end of data is encountered. If string-1 is 
not found, one of the following actions takes place. 


° For FIRST, LAST, or ALL - a "NO xxxxx FOUND" message is dis-~ 
played in the upper right-hand corner of the screen. 


° For NEXT - a "BOTTOM OF DATA REACHED" message is displayed. 
e For PREV - a "TOP OF DATA REACHED” message is displayed. 


When "BOTTOM OF DATA REACHED" or "TOP. OF DATA REACHED" is dis- 
played, the user may press the Find PF key (Cfor either FIND or 
CHANGE) or the Change PF key (for CHANGE) to continue searching by 
wrapping to the top Cor bottom) of the data. If no occurrence is 
papell a ialisdi in the data, a "NO xxxxx FOUND". message is dis~ 
played. 


Conditions for Character String Match 
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The conditions for a successful "match" with string-1l may be 


cour ones based on whether the data string begins and/or ends 
ith a non-alphameric character (i.e., a special character or 
blank). The operands are: CHARS, PREFIX (may be abbreviated 
PRE), SUFFIX (may be abbreviated SUF), and WORD. In the following 
illustration, the underscored strings would be found, and the 
non-underscored strings would be ignored (skipped over). 
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CHARS 'DO' DO DO ADO DO DO (DONT) 
PREFIX 'DO! po (DONT) 


SUFFIX 'DO' 00 DO (DONT) 


WORD 'DO' BO jaie; (DONT) » 





If this operand is omitted, the default is CHARS. 


Range and Column Limitations 


Under edit, the lines to be searched may be limited by first using 
the "X"™ or "XX" line commands (see "Excluded Lines"), and then 
specifying one of the following operands on the FIND or CHANGE 
command: 


X - Scan only lines which are excluded from display. 
NX - Scan only lines which are not excluded from display. 


If this operand is omitted, both excluded and non-excluded lines 
will be searched. When an excluded line is searched and string-l 
is found, the line is automatically redisplayed (i.e., it is 
"pyopped” out from the block of excluded lines). 


Note: The X/NX eperend is not defined when using FIND under 
browse. 


If the "col-1" and "col-2" operands are typed (two integers sepa- 
rated by a comma or at least one blank), they indicate the start- 
ing and ending column positions for the search. If col-1 is 
specified without col-2, the string will be found only if it 
starts in the specified column. If neither col-1 nor col-2 is 
specified, the search will continue across all columns within the 
current boundary columns. See description of BOUNDS commands. 


Use of Text Strings 


A text string, which may be used as string-1 in a FIND or CHANGE 
command, allows the search to be satisfied without regard to 
upper/lower case alphabetics. Example: FIND T°CONDITION NO. 1' 
would successfully find any of the following: 


CONDITION NO. 1 
Condition No. 1 
condition no. l 
CONDItION nO. 1 


An ordinary delimited string, such as: FIND 'CONDITION NO. 1'* 
would find only the first example listed above. 


Within the text string itself, is is immaterial whether alphabet- 
ics are typed in upper or lower case (even if CAPS mode is off). 
For example, all the following have the same effect: 


FIND T'Edit Commands’ 


FIND T*EDIT COMMANDS'* 
FIND Tredit commands! 
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Use of Picture Strings | 
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A picture string, which may be used as string-1 in a FIND or 
CHANGE command, allows the search to be satisfied when a partic~- 
ular type of character is encountered. Special characters are 
used within the picture string to represent the type of character 
to be found, as followms: 


STRING MEANING 


Pt=" - any character (don't care) 

P'-' = any non-blank character 

P’'.* =| any non- displayable Cinvalid) character 

P*#* - any numeric character (0-9) 

P't-" - any non-numeric character 

P'a"’ =- any alphabetic character Cupper or lowercase) 
P*¥<* - any lowercase alphabetic character 

P'>' - any uppercase alphabetic character 

P'S" = any special character (not alpha or numeric) 


Any special characters other than the ones listed above are inval- 
id within a picture string. A picture string may also include any 
alphabetic or numeric characters, in which case the characters 
represent themselves. 


Examples of picture strings: 


P'###" - a string of three numeric characters 

P'-= -* - any two non-blank characters surrounding a blank 
Ph - any non-displayable character 

Pp? #t - a blank followed by a numeric character 

P'#AB" - a numeric character followed by "AB" 


Examples of FIND and CHANGE commands using picture strings: 


FIND P*.* - find next non-displayable character 
FIND P'~* 72 - find next non-blank character 
in column. 72 
C ALL Pt=" * * 73 80 ~ change any characters in columns 
73-80 to blanks 
Pipe et” . of. - find the next line with a blank in 


column 1 followed by a non-blank 


When the picture string P*." is used to find or change a 
non-displayable character, the hexadecimal representation of the 
character is shown in the confirmation message which appears in 
the upper right-hand corner of the screen. 
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ADVANCED FEATURES 


The following commands are described in this section. 


Line commands: 


MASK X Cexclude) 
< (data left) S (show) 
> (data right) F (first) 
C Ccolumns left) L (Clast) 
> Ccolumns right) TABS 
BOUNDS 
Primary commands: 
COPY NULLS 
MOVE TABS 
CREATE PROFILE 


REPLACE HEX 


Mask Definition 


The mask is used in conjunction with the "I" Cinsert), "TE" Ctext 
entry), and "TS" (text split) line commands. Whenever a new line 
is inserted, it is pre-filled with the contents of the mask. Ini- 
tially, the mask contains all blanks. 


To display the mask, the characters "MASK" are entered in the line 
command area, overtyping the line number. When the ENTER ney is 
pressed, the mask is displayed at the designated position. 


MASK - Display mask definition line 


Once displayed, the mask may be changed to allow pre- Bntey of data 
on inserted lines. An example is shown in Figure 32. In this 
example, the mask has been displayed and the characters "/*" and 
"x/" have been entered at the desired positions on the mask line. 
Five new lines are then inserted following line 1700. The second 
part of the example shows that the new lines contain the contents 
of the mask. 


The mask line may be removed from display by entering a "D" in the 


line command area, or by entering a RESET primary command. The 
mask line is never saved as part of the data. 


The mask remains in effect Ceven if it is not displayed) until it 
is again changed by the user. The contents of the mask are 
retained in the current edit profile, and automatically used the 
next time the user edits the same type of data. 
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EDIT --- SPFDEHO.SAMPLE. PLICEDI21PM) - oh ol COLUMNS 001 072 
- COMMAND INPUT ===> | ; SCROLL ===> HALF 
001100 ELSE ; . 
601200 /* COMPUTE PARM LENGTHS */ 
001300 DO; 
SCOLS> wenn tenn m Lenn ban nm Zon pon an Je ew penne gen Gown tenn G aren teenn Jo — 
=MASK> 7* %/ 
001400 LP = 83 
001500 DO WHILE (EDIMPROJ(LP) = ' ')3 
; LP = LP-1; ee 
END; 
DO K=1 TO 43 
IF EO(MLIB(K,1) ~= ' * THEN 
DO; 
—LLCK) = 83 
DO WHILE 
~ CEDEMLIBCK,LL(K)) = ° 833 
= LL(K)-23 


RETURN CODE(0)3 
END ED[21PM; 
DEE IEEE HEI IEEE NEI IEEE EHEC EIEN BOTTOM OF DATA 36966363696969656969696 96969696366 9696363 IEIEIE 


EDIT --- SPFDEMO.SAMPLE.PLICED[21PM) - 01. o1 COLUMNS 001 072 
COMMAND INPUT === SCROLL ===> HALF 
001100 ELSE 

001200 COMPUTE PARM LENGTHS 

001300 


=MASK> 

001400 

001500 DO WHTLE CEDEMPROJ( LP) 
001600 ' LP = LP-1; 

001700 END; 


001800 DO K=1 TO 4; 

001900 IF ED{MLIB(K,1) -= ' 
002000 DO; 

002100 LL(K) = 83 

002200 BO WHILE 

002300 (EDEMLIB(K,LL(K)) = 
002400 LLCK) = LLOK)~-15 
002500 END; 

002600 END ; 

002700 — ELSE 

002800 LL(K) 

002900 . END; 





Figure 32. Edit - Define Mask Example 
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Indentation Changes 


The contents of a line Cor block of lines) may be shifted left or 
right by means of the shift line commands. The two forms of these 
commands are: 


w>" and "<" for "data" shifting 
")" and "c" for "column" shifting 


Data shifting attempts to shift the body of a program statement 
without shifting the label or comments, and will prevent loss of 
data. Column shifting shifts information without regard to its 
contents, and may result in the loss of data. (See further dis~ 
cussion below.) 


To shift the contents of a line left, the single character "<" or 
"CC" is entered in the line command area, overtyping the line num- 
ber. When the ENTER key is pressed, the data in the line contain~ 
ing the command is shifted left by two column positions (two is 
the default for shift operations). 


shift line left 2 positions 

shift line left "n™ positions 

shift block of lines left 2 positions 
shift block of lines left "n" positions 


shift line left 2 positions 

shift line left "n"™ positions 

shift block of lines left 2 positions 
shift block of lines left "n"™ positions 





To shift a block of lines left, "<<" or "CC" is entered in the 
line command area of the first and last lines to be shifted. The 
first and last lines need not be on the same page; scrolling may 
be used between entering the first command and the second command. 


The equivalent commands for right shifting are ">", ")", ">>" and 
wypr. : 


shift line right 2 positions 

shift line right "n" positions 

shift block of lines right 2 positions 
shift block of lines right "n™ positions 


shift line right 2 positions 

shift line right "n" positions 

shift block of lines right 2 eer ciens 
shift block of lines right "n" positions 





A number may be entered following any of the shift commands to 
indicate the number of column positions to be shifted. For exam- 
ple, ">>5" entered on the first or last Cor both) lines to be 
shifted would cause a right shift of five column positions... 


Shifting occurs within column boundaries that may be changed by 
the user. Default column boundaries are established by edit, 
based on the data set "type" Clowest level qualifier of the data 
set name). The default boundaries are normally the first and last 


columns where source text may be entered for the particular pro- 


gramming language. See BOUNDS command for a discussion of default 
boundaries and the procedures for changing them. 
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Data Shifting -— ">" and "<" 


Within the column boundaries, data shifting is accomplished by 
squeezing out multiple blank characters at one end of the data, 
and increasing the number of blanks at the other end. The follon- 
ing rules are followed in performing a data shift. 


° Non-blank characters are never deleted or truncated. 
° A single blank is never deleted. 


° Within apostrophes, the number of multiple blanks is never 
changed. 


° Non-blank characters are never shifted into or out of the left 
column boundary position (normally the label field). 


° If a shift cannot be completed, it is partially performed and 
the line number is replaced with the following intensified 
Warning message: ==ERR>. The warning message may be removed 
via the RESET primary command, or by overtyping the message or 
data on that line. 


Figure 33 shows a before-and-after example of data shifting. The 
block of lines, starting at line 1910 through line 1980, is 
shifted left four column positions. 


Column Shifting - "2" and "(" 
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Column shifting is accomplished by simply moving all of the 
characters (within the column boundaries) left or right by the 
designated number of positions. There is no squeezing or increas- 
ing of blanks. There is no restriction on shifting non-blank 
characters into or out of a column boundary position. Characters 
shifted beyond a column boundary postion are lost, with no warning 
message. 
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EDIT --- SPFDEMO.MYLIB.PLI(TESTDIR) - Ol. 03 wen nnn ne nnn -- COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
601800 END 3 
001900 ELSE 
<<q DO; 
001920 PUT FILECSYSPRINT ) 
6019306 EDIT('TEST NOTES ERROR RETURN FROM D-I-R') 
001940 (COLUMN( 21),A034) )3 
001950 PUT FILECSYSPRINT) SKIP(2) 
061960 DATACERROR~-F LAG, CARD-IMAGE » ANSWER ) 5 
ERROR-FLAG = '0'B; 
END ; 
END; 

002200 END TESTOIR; 
HHI HHH IH ICI IE HEH HHH HHH NHI HION BOTTOM OF DATA 2363631 II III IE IEEE IE IEE TENE EH HENCE IEEE IEE 


EDIT --- SPFDEMO.MYLIB.PLI( TESTDIR) - 01.03 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
001800 END; 

001900 ELSE 

001910 DO; 

001920 PUT FILE(SYSPRINT) 

001930 EDIT(''TEST NOTES ERROR RETURN FROM D-I-R') 

001940 (COLUMN(21),A(034))3 

001950 PUT FILE(SYSPRINT) SKIP(2) 

001960 DATA( ERROR-FLAG, CARD-IMAGE , ANSWER ) ; 

001970 ERROR-FLAG = '0'B; 

001980 END; 

002000 ; 

002100 END; 

002200 END TESTDIR; 


" FERESIEIIEIE IE IEIEIEDEIEDE ETE IEE IE IEIEIEMEIEIEIEIEIEIEIEREEN BOTTOM OF DATA 336369636369696269696969696 9696963696636 96969696 6969696 





Figure 33. Edit - Left Shift Data Example 
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- Boundary Column Definition 


To display the column boundary definition line, the characters 
"BOUNDS" Cor an acceptable abbreviation) are entered in the line 
command area, overtyping the line number. When the ENTER key is 
pressed, the boundary. definition line is inserted at the desig- 
nated position. ie 





BOUNDS - Display boundary definition: Line - 
Command abbreviations: BOUND, BNDS, BND. 


The column boundaries are used to Limit the scope of: 






© Left and right shift line commands ' 
® FIND and CHANGE commands when explicit columns were not spec” 
ified by the user 
ax Text entry, text split, and text flow line commands 
° Overlay line command 
° Left and right scrolling. 


The effect on left and right scrolling is as follows: 

1. <A left scroll will stop at the left bound, anda right scroll 
will stop at the right bound. A subsequent left or right 
scroll will go beyond the bound Cassuming the bound is not at 
the left-most or right-most column position). 

2. The initial display (when edit is entered) will be 
pre-scrolled so that the left boundary column is the first 
column displayed. . : 

The boundaries are initialized by edit based on the data set 

“"typa™ (the lowest level qualifier in the data set name) and 


whether or not the data is sequence numbered. The default left 
and right column boundaries are shown in Figure 34. 


RECORD DATA 7 
FORMAT TYPE NUMBERED UNNUMBERED 
aa 


aE PE ea ee, 
FIXED | ASM or | . 
LENGTH ASSEMBLE | 1, 71 
, >. 


CANY) LRECL 1, LRECL 


Figure 34. Edit - Default Column Boundary Settings 














VARIABLE 
LENGTH 
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The user may change the boundaries by displaying the boundary 
definition line and changing its contents. The boundary defi- 
nition line contains a single "<" character indicating the posi- 
tion of the left column boundary, and a single ">" character 
indicating the position of the right column boundary. If the user 
has already changed the boundaries, he may revert to the default 
bounds by displaying the boundary definition line and blanking 
out its contents. The ERASE EOF key may be used for this purpose. 


If the default boundaries are in effect, they are automatically 
adjusted whenever NUMBER mode is turned on or off. If the user 
has changed: the bounds from the default settings, they are not 
affected by the. setting ‘of NUMBER mode. 


Figure 35 shows an emake of the boundary definition line 
displayed together with the column identification line. In this 
example, the left bound is currently set at column 42 and the 
right bound at column 70. 


The boundary definition line may be removed from display by enter- 
ing a "D" in the Line command area, or. by entering a RESET primary 
command. The boundary definition line is never saved as part of 
the data. 


The boundary definition line is retained in the current edit pro- 
file, and automatically used the next time the user edits the same 
type of data. 


EDIT ~--~- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.00 --------------- ~~ COLUMNS 001 072 
COMMAND INPUT ===> _ SCROLL ===> HALF 
001400 IF BROSMEMB(1) -= ' ' THEN 7* IF MEMBER SELECTED, 


001500 DO; 

001600 ZINCLUDE: SYSLIB( BROFINDM ) FIND MEMBER 

ZCOLS> nnn tenn n enn pon Qe bens Jan tn mr bn en mn ton Geren teennJa= 
=BNDS> ‘ <. > 
001700 IF BRORCODE = 0 THEN IF NO ERRORS, */ 
001600 DO; 7% %/ 
001900 ZINCLUDE SYSLIB(BROPDSH ) 3 /* SET UP PDS HEADER */ 
002000 ny CALL CBRO (TLD,TDC); 7* CALL COMMON BROWSE */ 
002100. END; 7*® */ 
G02200 ELSE 7% ELSE; */ 
002300 BROMLIST = OFF; 7% TURN OFF LIST FLAG */ 
602460 END; 7% */ 
002500 ELSE 7* ELSE (NOTHING SELECTED) ,%/ 
002600 BROMLIST = OFF3 7% TURN OFF LIST FLAG */ 
002700 END; 7* END OF LOOP */ 
002800 BROSMEMB = BLANKS; 7* CLEAR SELECTED MEMBER */ 
002900 END; 7* */ 
HHH HIE RICHI IC ION EHH IIE HEHE MH HHMI KHHININWIH"E BOTTOM OF DATA 3365396996369 356 IE HEI IE IE IESE NE HE TEE HEHEHE HEE 





Figure 35. Edit - Boundary Definition Line 
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Excluded Lines 
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When editing a program segment which exceeds the screen data size, 
it is often difficult to determine whether the control structure 
and indentation levels are correct. The excluded lines capabili- 
ty allows blocks of linas to be collapsed so that the overall con- 
trol structure may be viewed. The lines are excluded from display 


but are not deleted in the data. 


Excluded lines may also be used in conjunction with the "X" and 
"NX" options of the FIND and CHANGE commands to limit the scope of 
search, and/or to easily identify lines which have been found or 
changed by causing them to "pop out" of a block of excluded lines. 


To exclude a line, the single character "X" is entered in the line 
command area, overtyping the line number. A number may follow the 
"X" to indicate that more than one line is to be excluded. For 
example, "X5" would cause five lines to be excluded, starting with 
the line containing the "X5". When the ENTER key is pressed, the 
line(s). are replaced with a single message line, which indicates 
how many lines were excluded. 


xX ~ Exclude line 


Xn - Exclude "n" lines 
XX - Exclude block of lines 





To exclude a block of lines, the double character "XX" is entered 
in the line command area of the first and last lines to be 
excluded. The first and last lines need not be on the same page. 


Figure 36 shows a before-and-after example of excluded lines. 
The block of lines, starting at line 1600 through line 2600, is 
excluded from display and replaced witha single message line. 


Excluded lines may be redisplayed by entering the RESET primary 
command. Alternatively, one or more excluded lines may be redis- 
played by entering "S" (show), "F" (first), or "L"® Clast) tn the 


-line command area of the "EXCLUDED LINES” message, overtyping the 


dashes which are normally in that area. Each of these line com- 
jal be followed by a number to cause redisplay of more than 
one line. 


BS) ~ Show line 

Sn - Show "n" lines 

F ~ Show first line 

Fn - Show first "n" lines 
L = Show last line 

Ln - Show last "n" lines 
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EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.02 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
000700 ZINCLUDE SYSLIB(BROLISTM); LIST MEMBER NAMES */ 
000800 END; x/ 
000900 ELSE ELSE, %/ 
001000 DO; */ 
001100 BROMLIST = OFF3 TURN OFF LIST FLAG */ 
001200 BROSMEMB = BROMMEMB;. MOVE MEMBER NAME TG %/ 
001300 END; ‘SELECTED’ MEMBER */ 
001400 IF BROSMEMB(1) -= ° * THEN IF MEMBER SELECTED, %/ 
BO; */ 
ZINCLUDE SYSLIB( BROFINDM); : FIND MEMBER %/ 
IF BRORCODE = 0 THEN IF NO ERRORS, */ 
DO; %/ 
ZINCLUDE SYSLIB( BROPDSH };/* SET UP PDS HEADER %/ 
CALL CBRO (TLD,TDC); 7% CALL COMMON BROWSE 
/* 
(* ELSE, 
7% 
BROMLIST = OFF; TURN OFF LIST FLAG 
BROSMEMB = BLANKS; CLEAR SEL. MEMBER 
END; 
END; 
ELSE 
BROMLIST = OFF; TURN OFF LIST FLAG 
END; 7* END OF LOOP 
BROSMEMB = BLANKS; 7% CLEAR SELECTED MEMBER 
END; 7% 


EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.02 COLUMNS O01 072 

COMMAND INPUT === SCROLL ===> HALF 

000700 ZINCLUDE SYSLIB(BROLISTM)3$ 7% LIST MEMBER NAMES */ 
000860 END; ¥/ 
000900 ELSE ELSE, */ 
001060 DO; ¥/ 
001160 BROMLIST = OFF; TURN OFF LIST FLAG */ 
001200 BROSMENB = BRCMMEMB; MOVE MEMBER NAME TO ¥*/ 
001300 END 3 "SELECTED’ MEMBER ¥/ 
001400 IF BROSMEMB(1) += * ' THEN IF MEMBER SELECTED, */ 
001500 DO; ¥/ 
srr ee ee FF ee ke we ee ~ 11 LINE(S) NOT DISPLAYED 

002700 END; */ 
002800 ELSE ELSE (NOTHING SELECTED ),*/ 

002900 BROMLIST = OFF; 7% TURN OFF LIST FLAG ¥/ 
003000 END ; 7* END OF LOOP ¥/ 
003100 BROSMEMB = BLANKS; 7* CLEAR SELECTED MEMBER */ 
003200 END; J %/ 
HIKE HHH HHH IH HIE HHH HMI HI HIM HIHNH BOTTOM OF DATA 2636936269696 IIE II IE NIE IEEE IEEE HEH NHN 





Figure 36. Edit - Excluded Lines Example 
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-The "S" line command causes the block of excluded lines to be 


scanned, and one or more lines selected for redisplay. The 
selected lines are those with the Left-most indentation levels 


Ci.e, with the fenest number of leading blanks). If "S3" is 
entered, for example, the three lines With the left-most indenta-. 


tion level will be redisplayed. If more than three lines exist at 
this indentation level, the first three will be displayed. 


The "F™ line command causes one or more lines at the beginning of 
the -block to be redisplayed. The "L"™ line command causes one or 
more lines at the end of the block to be redisplayed. 


Figure 37 shows a before-and-after example of redisplaying 
excluded lines. The command "S3" is entered in the line command 
area of the "EXCLUDED LINES" message. Three lines with the high- 
est indentation level are redisplayed. 


Any line command that normally operates ona single line may be 
entered in the line command area of the "EXCLUDED LINES” message. 
For example, a "D" entered on that line will delete the entire 


block of excluded lines. This feature is particularly useful in 


conjunction with the shift commands. Suppose, for example, you 
want to "data™ shift all lines to the left by 4 column positions. 
Proceed as follows: 


1. . the first data line, enter "X99999". This will exclude all 
ines. 


2. econo "EXCLUDED LINES” message, enter the shift command 
weg, ; 


3. In the primary command area, enter the RESET command to bring 
the lines back into view. 


Note: Excluded lines need not be redisplayed before saving the 
near a "EXCLUDED LINES" massage line is never saved as part of 
the data 
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EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.02 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
000700 ZINCLUDE SYSLIB(BROLISTM); LIST MEMBER NAMES */ 
000800 ; */ 
000900 ELSE, */ 
001000 . 
001100 BROMLIST OFF; TURN OFF LIST FLAG 
001200 BROSMEMS BROMMEMB ; MOVE MEMBER NAME TO 
001300 END; ‘SELECTED’ MEMBER 
001400 IF BROSMEMB(1) ~= ° * THEN IF MEMBER SELECTED, 
DO; 
- = = = = = = = = = ey - 11 LINE(S) NOT DISPLAYED 
END; */ 
ELSE ELSE (NOTHING SELECTED )..%/ 
BROMLIST = OFF; 7* TURN OFF LIST FLAG */ 
END}; 7*% END OF LOOP */ 
BROSMEMB = BLANKS; 7% CLEAR SELECTED MEMBER */ 
END; /¥® */ 
SEEEIEIE IE SEIEIEIEIE NEED IEE IEE IEE EIEN EEE IEEE BOTTOM OF DATA 369696363636369696963636 3630963 ESE EEE 


EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.02 COLUMNS 001 072 
COMMAND INPUT === SCROLL ===> HALF 
000700 ZINCLUDE SYSLIB(BROLISTM) 3 LIST MEMBER NAMES %/ 
000800 ¥/ 
000900 ELSE, %/ 
001000 %/ 
001100 BROMLIST = OFF; TURN OFF LIST FLAG 
001200 BROSMEMB = BROMMEMB; MOVE MEMBER NAME TO 
001300 END; 'SELECTED' MEMBER 

001400 IF BROSMEMB(1) ~= ' ' THEN IF MEMBER SELECTED, 

001500 DO; 

001600 “INCLUDE SYSLIB(BROFINDM); 7% FIND MEMBER 

001700 IF BRORCODE = 0 THEN IF NO ERRORS, 

--- - - ~- - = = = = = = = = = & LINE(S) NOT DISPLAYED 


002200 ELSE 7® ELSE, x/ 
~~ et ee ee ee ee ee ee ee he he 64 ULLINECS) NOT DISPLAYED 
002700 END $ 7% %/ 
002800 ELSE 7*% ELSE (NOTHING SELECTED ),*/ 
002900 BROMLIST = OFF; /* TURN OFF LIST FLAG */ 
003000 END; 7* END OF LOOP %/ 
003100 BROSMEMB = BLANKS; 7% CLEAR SELECTED MEMBER ¥/ 


003200 END; 7¥ */ 
SEI JEIEIEIEIEIEIEIEIEIEIEIE EIEIO BOTTOM OF DATA 36569636963696969036969696 9696909636989 9. SEED EDEREIE 





Figure 37. Edit - Show Lines Example 
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Data Merging and Segmentation 


Merging or segmentation of data is accomplished by moving or copy~ 
ing lines into or out of the data being edited. To merge data, a 


-primary command is used to specify the source of the move or copy, 


and a line command is used to specify the destination. To segment 
data, the process is reversed. 


Merging Data 
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The COPY and MOVE primary commands Cnot be confused with the line 
commands of the same name) are used to specify a member of a par- 
titioned data set or a sequential data set to be copied into the 
data being edited. If the MOVE command is used, the member or 
sequential data set is deleted following a successful read oper- 
ation. (For a concatenated sequence of SPF libraries, the delete 


-occurs only if the member was in the first library of the 


concatentation sequence.) These commands are of the form: 


COPY [member-name] 


MOVE Cmember-name] 


If the "member-name” operand is entered, the member is fetched 
from the data set Cor concatenated sequence of data sets) current- 
ly being edited. If the operand is omitted, a menu will be dis- 
played to allow specification of any partitioned data set member 
or sequential data set as the source for the COPY or MOVE. 


The destination for the COPY or MOVE is specified by the "A" Caf- 
ter) or "B® Chefore) Line command in the data being edited. The 
TA" or "B" line command need not be entered if the data being 
edited contains no lines (new member or empty sequential data 
set). Note that a number may not follow the "A" or "B" line 
commen when it is used in conjunction with a COPY or MOVE primary 
command. 


If the member-name operand is omitted on the COPY or MOVE primary 
command, the "A™ or "B" line command must be entered before the 
data set menu will be displayed Cunless the data being edited con- 
tains no lines). 


The COPY menu allows a range of lines in the source data set to be 
pore} here The line searching criteria must also be specified, as 
follows: 


° STANDARD - search for 8-character "standard" line numbers 

COBOL - search for 6-character COBOL line numbers 

® RELATIVE - ignore line numbers in the data, and interpret the 
specified line numbers as relative to the start of the data. 


See "Sequence Number Generation and Control" for a further dis- 
cussion of standard and COBOL line numbers. 


Figure 38 shows an example of the COPY command. Member CBLCODE1] © 
is being edited in data set SPFDEMO.XXX.COBOL. A COPY command 
with no operand is entered in the primary command area, and an "A" 
lryne command is entered at line 500. When the ENTER key is 


pressed, the COPY menu is displayed (second half of the figure). 


In this example, lines 1000 through 2300 of member ENVD in data 


set MASTER.OLD.COBOL are to be copied. When the menu has’ been 


filled in and the ENTER key pressed, the lines will be copied and 
inserted after line 500, and the edit data will be redisplayed. 
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EDIT -~- SPFDEMO.XXX.COBOL(CBLCODE1) - 01.01 COLUMNS 007 078 
COMMAND INPUT ===> COPY SCROLL ===> HALF 
HHH HII HHH NIKI HK HH HH HHH HHH KHAKI TOP OF DATA 363696362626 9696 9696 56966 EIEN IEE IEE EE FEE EES IE IE 
000100 IDENTIFICATION DIVISION. 

000200 PROGRAM-ID. SMPLCBL «+ SAMPLE CBL PROGRAM. 

000300 AUTHOR. JOE BLOW. 

000400 ; 

Aus ENVIRONMENT DIVISION. 

000600 

000700 DATA DIVISION. 

000800 FILE SECTION. 

000900 FD SYSPRINT 

001000 LABEL RECORD IS OMITTED 

001100 DATA RECCRD IS PRINT-LINE. 

001200 01 PRINT-LINE. 

001300 02 LINE-FIELD PICTURE X(121). 

001400 WORKING-STORAGE SECTION. 

001500 O01 PRINT-VALUE PICTURE X(121) 

001600 VALUE * PRINT LINE PRODUCED BY SAMPL 
001700 "E CBL PROGRAM.'. 

001800 

001900 PROCEDURE DIVISION. 

002000 BEGIN. 

002100 OPEN OUTPUT SYSPRINT. 

002200 WRITE PRINT-LINE FROM PRINT-VALUE. 

002300 CLOSE SYSPRINT. 

002400 STOP RUN. 

HERR HII HII HHH IEEE HHMI BOTTOM OF DATA 226363632 IH IEEE 


EDIT - COPY MENU 
“CURRENT” FILE: SPFDEMO.XXX.COBOL(CBLCODE1 ) 


SPF LIBRARY: 
PROJECT MASTER 
LIBRARY ===> OLD 
TYPE COBOL 
MEMBER ENVD_ 


CMS FILE: 
FILE ID 
MEMBER 
IF NOT LINK SPECIFY: 
OWNER'S ID DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD (IF PASSWORD PROTECTED) 


LINE NUMBERS (BLANK FOR ENTIRE MEMBER OR SEQUENTIAL FILE): 
FIRST LINE 
LAST LINE 
NUMBER TYPE (STANDARD, COBOL, OR RELATIVE) 


PRESS ENTER TO COPY OR PRESS END KEY TO CANCEL COPY 





Figure 38. Edit —- COPY Command Example 
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Secmentine Data 
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~The CREATE and REPLACE erinerd commands are used to specify a 


member of of a partitioned data set or a sequential data set to be 
written from the data being edited. CREATE may be used only to 
specify a member of a partitioned data set. It will add the mem- 
ber providing a member of the same name does not already exist in 
the data set. REPLACE will add or replace a’‘member in a parti- 
tioned data set or rewrite an entire sequential data set. The 
commands are of the form: 


CREATE [Emember-namel] 
Command abbreviation: — 


REPLACE [Emember-name] 






Command abbreviations: REPL, REP 





If the "member-name™ operand is entered, the member will be writ- 
ten in the data set currently being edited. (For a concatenated 
sequence of SPF libraries, the member is always written in the 
first library of the concatenation sequence.) If the operand is 
omitted, a menu will be displayed to allow specification of any 
partitioned data set member or sequential data set as the destina-~ 
tion of the operation. 


The source of the operation is specified by the "C™ (copy) or "M" 
(move) line commands. The block form -~- "CC" or "MM" -- may be 
used to specify the first and last lines. If the "M" or "MM" line 
command is used, the lines are deleted from the data being edited 
following a successful write operation. The form "Cn" or "Mn", 
where "n" is a large number, may be used on the first data line to 
copy or move all the data. 


If the member-name operand is omitted on the CREATE or REPLACE 
primary command, the line command(s) designating the source of 
the operation must be entered before the data set menu Will be 
displayed. 


Figure 39 shows an example of the REPLACE command. Member 
CBLCODE1 is being edited in data set SPFDEMO.XXX.COBOL. Lines 800 
through 1700 are to be moved, as indicated with the "MM" line com- 
mands. The entire contents of sequential data set TEMP.SAVE are to 
be replaced with lines 800 through 1700. 


Note: The data which is written to the destination data set is 
renumbered if both NUMBER mode and AUTONUM are in effect. A 
- source listing of the data is also recorded in the SPF list data 


set for eventual printing, provided PRINT mode is in effect. 
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EDIT --- SPFDEMO.XXX.COBOL(CBLCODE1) ~ 01.01 COLUMNS 007 078 
COMMAND INPUT ===> REPLACE — SCROLL ===> HALF 
000560 SELECT SYSPRINT 
000570 ASSIGN TO UT-S-PRINT. 
000600 
000700 DATA DIVISION. 
FILE SECTION. 
FD. SYSPRINT 
LABEL RECORD IS OMITTED 
DATA RECORD IS PRINT-LINE. 
O01 PRINT-LINE. . 
02 LINE-FIELD PICTURE X(121). 
WORKING-STORAGE SECTION. 
01 PRINT-VALUE PICTURE X(121) 


VALUE ' PRINT LINE PRODUCED BY SAMPL 
"E CBL PROGRAM. '. 


PROCEDURE DIVISION. 
BEGIN. 
OPEN OUTPUT SYSPRINT. 
WRITE PRINT-LINE FROM PRINT-VALUE. 
CLOSE SYSFRINT. 
STOP RUN. 
HH KHKH HHI IIE IE IIE IE NIE IEEE BOTTOM OF DATA 3€369¢9696969696969696 96969696 9596969696 96969690 9E EIEN 





ween anon een e eee ----- EDIT - REPLACE MENU ------------------------------ 
"CURRENT" FILE: SPFDEMO.XXX.COBOL(CBLCODE1 ) 


ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 


PROJECT ===> SPFDEMO 
LIBRARY ===> XXX 
TYPE ===> COBOL 
MENBER ===> 
CMS FILE: FOR NEW CMS FILE: 
FILE ID ===> NEWFILE COBOL Al_ RECFM ===> (F OR V) 
MENBER ===> LRECL ===> 
IF NOT LINKED, SPECIFY: 
OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


UPDATE PASSHORD ===> 


PRESS ENTER TO REPLACE 
PRESS END KEY TO CANCEL REPLACE 


Figure 39. Edit ~ REPLACE Command Example 
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Nulls Control 


The NULLS mode determines whether trailing blanks in each data 


field are written to the screen as blanks or nulls. The term "da- 


ta field" normally refers to the 72 characters of data on each 
line. Using hardware tabs, however, each line can be split into 
multiple fields (see "Tabs Definition and Control™). 


NULLS mode may be turned ion or off by using the NULLS command. 
Format: 


NULLS [ON/OFF] CALL] 





Command abbreviation: NULL 


The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. 


The ALL operand is valid only when NULLS mode is turned on. If 
ALL is typed, it causes all trailing blanks to be replaced with 
nulls and all-blank fields to be replaced with all-nulls. If ALL 
is omitted, one trailing blank is preserved (followed by nulls) 
and all-blank fields continue to contain blanks. 


Blank characters (Chexadecimal G0") and null characters 
Chexadecimal '00") both display as blanks. The reason for trail- 
ing nulls is to simplify use of the INSERT key on the IBM 3270 
keyboard. This key may be used to insert characters ona line, 
providing the line contains trailing nulls. In addition to using 
the NULLS command, the user may create nulls at the end of a line 
via the ERASE EOF or DELETE key. Null characters are never stored 
in the data; they are always translated back to blanks. 
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Three types of tabs are available: "software" tabs, "hardware" 
tabs, and “logical” tabs. 


"Software" tabs are used by edit to reposition the cursor. When- 
ever the cursor is in the data portion of a line and the ENTER key 
is pressed, the cursor is moved to the next software tab position 
Cproviding software tabs have been defined). 


"Hardware”™ tabs allow the use of the TAB FORWARD and TAB BACKWARD 
keys to move the cursor to user-defined column positions within 
the data. This is accomplished by inserting additional attribute 
bytes in each 72-character data area, which splits the data area 
into multiple fields. When the TAB FORWARD or TAB BACKWARD key is 
pressed, the cursor is moved to the screen position immediately 
following the next or previous attribute byte. There are always a 
least two attribute bytes on each edit line; one at the beginning 
of the line number field, and one at the beginning of the data. 


The advantage of hardware tabs is that no program interrupt is 

generated when the TAB FORWARD and TAB BACKWARD keys are pressed. 

The disadvantage is that each attribute byte occupies a screen 

ete and may not be overtyped. The attribute bytes display as 
anks. 


“Logical” tabs are used by edit to break up strings of data 
entered ona line and reposition the strings to user-defined tab 
positions. The beginning of each string is indicated by a 
user-designated special character. See discussion of TABS prima- 
ry command. . 


Note: Tabs are not functional when using the text entry (TE) line 
command. 
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Use of tabs is controlled by two cotimands: The tabs line command 
which defines tab positions, and the TABS primary command which is 
used to turn TABS mode on and off. 


Tabs Line Command 


The tabs line command is used to define tab positions for all 
three types of tabs. To display the tab definition line, the 
characters "TABS" or “TAB” are entered in the line command area, 
overtyping the line numbers. When the ENTER key is pressed, the 
tab definition line is inserted at the designated position. 


TABS - Display tab definition line 


Command abbreviation: TAB 





Software tab positions are defined by typing an underscore (_) or 
hyphen (-) at each desired column position on the tab definition 
line. Two or more consecutive underscores or hyphens may be typed 
to define a software tab field, which causes the cursor to be 
repositioned to the first non-blank character within the field. 
If the tab field contains all blanks, the cursor is positioned at 
the beginning of the field. 


Hardware and logical tab positions are defined by typing an aster- 
isk (€%) at each desired column position on the tab definition 
line. The asterisks indicate the locations where the attribute 
bytes will be inserted (for hardware tabs) or the locations fol- 
lowing which strings will be repositioned (for logical tabs). 


Initially, the tab definition line contains all blanks. If the 
user displays the tab line and enters software tab definitions, 
they take effect immediately; each line contains a software tab or 
tab field at the designated column positions. Hardware and log- 
ical tab definitions do not take effect immediately. The aster- 
isks define the column positions, but the insertion of attribute 
bytes (hardware tabs) or the repositioning of data strings (Clog- 
ical tabs) does not occur unless TABS mode is ON. The user may 
enter or leave TABS mode via the TABS ON/OFF primary command. 


Figure 40 shows an example of the tab definition line displayed 
together with the column identification line. The tab line shows 
a software tab field extending from columns 2 through 39, anda 
hardnare/logical tab definition at column 43. 


The tab definition line may be removed from display by entering a 
"DD" in the line command area, or by entering a RESET primary com- 
mand. The tab definition line is never saved as part of the data. 


The tab definitions remain in effect Ceven if not displayed) until 
they are again changed by the user. Tab definitions are retained 
in the current edit profile, and automatically used the next time 
the user edits the same type of data. 
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‘ 
EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.02 COLUMNS 001 072 
COMMAND INPUT ===> _ SCROLL ===> HALF 

' 001400 IF BROSMEMB(1) -= ' * THEN © /* IF MEMBER SELECTED, */ 
oo1500—C DO; : %/ 
001600.  ZINCLUDE SYSLIB(BROFINDM) 5 FIND MEMBER 
001700 IF BRORCODE = 0 THEN | IF NO ERRORS; 

ZCOLS> ----4--- = Lon to 2 Jann nn nn tn en phone tn 7=- 
* 

: DR : */ 

-ZINCLUDE SYSLIB(BROPDSH)3/* - © SET UP PDS HEADER ¥*/ 

CALL CBRO (TLD,TDC); = §=-/% ~~ CALL COMMON BROWSE */ 

END; 7% */ 

ELSE 7® ELSE, %/ 
DO; (* */ 


BROMLIST = OFF; - 7® TURN OFF LIST FLAG */ 
BROSMEMB = BLANKS; 7% CLEAR SEL. MEMBER ¥*/ 

END ; 7% */ 
END; 7% %/ 


ELSE Bie ik 7¥® ELSE (NOTHING SELECTED) ,*/ 
BROMLIST = OFF3 7% TURN OFF LIST FLAG %/ 
END ; 7*® END OF LOOP */ 

BROSMEMB = BLANKS; 7* CLEAR SELECTED MEMBER */ 

END 3 7¥ ; %/ 

HEMI IEE HEIEIEIE NEE IEIEIE IEICE IEICE IEIEIEIEIEHIEIENNW BOTTOM OF DATA 36369696369696369696969696 96969696 226 EE IEIEIEIEIEIEIE 





Figure 40. Edit - Tab Definition Line 


TABS Primary Command 


TABS mode may be turned on or off by using the TABS primary 
command. Format: 


TABS {ON/OFF] [tab-character] [ALL] 





Command abbreviation: TAB 


The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. The "tab-character" and "ALL" oper- 
ands are valid only when TABS mode is turned on. 


The "tab-character™ operand consists of a single, non-alphameric 
(special) character. It defines the character to be interpreted 
as a logical tab when encountered on input. Example: 
TABS ON $ 
If the user then enters the following information on a line: 
SaaaaaSbbb$cccce 
the data "aaaaa" will be repositioned after the first tab column 
Cas defined by an "*" in the tab definition line), the "bbb" will 
be repositioned after the next tab column, etc., as follows: 


TABS % % x 
, aaaaa bbb cece 
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If the "tab-character™ operand is not typed when TABS mode is 
turned on, hardware tabs are initiated by inserting attribute 
bytes at each tab position defined by an "*" in the tabs defi- 
nition line. If the ALL operand is coded, an attribute byte is 
inserted at all user-defined positions on each line, overlaying 
any characters in those positions. If the ALL operand is omitted, 
an attribute byte is inserted at each user-defined position on 
each line only if that character position currently contains a 
blank or null. 


Overlaying of characters with attribute bytes applies to the 
screen contents only; the attribute bytes are never recorded in 
the data. When TABS mode is turned off, the attribute bytes are 
Seale and the joverlaid character at each tab position is redis- 
playe 


In TABS mode, the user may temporarily cause the attribute bytes 
to be removed on a single line by blanking out the entire line 
command field or by placing the cursor directly under one of the 
attribute bytes and pressing the ENTER key. When the ENTER key is 
pressed again, the attribute bytes will be reinserted. 


Profile Display and Control 


The current edit profile may be displayed at any time by means of 
the PROFILE primary command. This command may also be used to 
define a new profile or switch to a different profile. Format: 


PROFILE [name] [number] 


Command ahbrevistions: PROF, PRO 





Both operands are optional, and may be coded in either order. The 
“name” operand consists of up to eight alphameric characters, the 
first of which must be alphabetic. The "number™ operand consists 
of a single digit in the range 0 to 7, inclusive. 


If neither operand is typed, the contents of the profile are dis~ 
played in the data area of the screen (Figure 41). The first 
three lines show the current mode settings. The remaining lines 
show the current contents of the MASK, TABS, and BOUNDS lines, 
together with the COLS positioning line. The MASK and TABS lines 
are not displayed if they contain all blanks, and the BOUNDS line 
is not displayed if it contains the default boundary positions. 


If the "name" operand is typed, and if the user already has a pro- 
file of that name, edit immediately switches to the specified pro- 
file and displays it. (Display of the profile may be avoided by 
typing a zero for the "number" operand. See below.) If a profile 
of the specified name does not already exist, a new profile is 
defined with that name. The initial content of the new profile is 
the same at the profile which was in effect when the PROFILE com- 
mand was entered. 


The "number™ operand controls the number of lines shown in the 
profile display. If the number 0 is typed, it prevents display of 
the profile. If the number 7 is typed, it forces display of all 
lines, even if the MASK and TABS are blanks and BOUNDS contains 
the defaults. 


Use of profiles may also be controlled from the edit data set 
menu. If the profile name field is left blank, the profile name 
defaults to the data set "type" (last qualifier in the data set 
name). If a name is entered, it overrides the "type" qualifier. 
In either case, if a profile of that name currently exists, it is 
used. If it doas not exist, a new profile is defined. The ini- 
tial content of the new profile has the default mode settings (see 
SCuUpe ne and Profiles™)}, all-blank MASK and TABS, and default 
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EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) ~ 01.02 -------------~---- COLUMNS 001 072 
COMMAND INPUT ===> _ , SCROLL ===> HALF 
SEIESEIEIEDE SESE IE IEEE IE IESE IESE HEN IESE DEBE IEEE IEEE TOP OF DATA 6969636969696969696 9696 969696 996 26 EEE IE IE IE DE HEHE IEEE IE IEE 
=PROF> ....PLI (FIXED - 80)... RECOVERY OFF....NUNBER ON STD...... cece eee ce eeee 
=PROF> ....CAPS ON....HEX OFF....NULLS OFF.... TABS OFF... cee cece eee eee c ec cnce 


=PROF> ....AUTONUM ON....PRINT OFF... .STATS ON... cece e cece rere cc ence cre cereccee 



























000700 ZINCLUDE SYSLIB(BROLISTM); 7% LIST MEMBER NAMES */ 
000800 END; 7% */ 
000900 ELSE 7*® ELSE, */ 
001000 DO; 7% */ 
001100 BROMLIST = OFF; 7* TURN OFF LIST FLAG */ 
001200 BROSMEMB = BROMMEMB; 7* MOVE MEMBER NAME TO ¥*/ 
001300 END; 7* 'SELECTED' MEMBER */ 
001400 IF BROSMEMB(1) ~= ' ' THEN 7* IF MEMBER SELECTED, */ 
0601500 DO; 7* */ 
001600 ZINCLUDE SYSLIB(BROFINDM); /%* FIND MEMBER %/ 
001700 IF BRORCODE = 0 THEN 7* IF NO ERRORS, */ 
001800 DO; /* %/ 
001900 ZINCLUDE SYSLIB(BROPDSH );/%* SET UP PDS HEADER ¥*/ 
002000 CALL CBRO (TLD,TDC); /* CALL COMMON BROWSE ¥*/ 
002100 END; 7*® */ 
002200 ELSE 7* ELSE, %/ 
002300 DO; 7* */ 
002400 BROMLIST = OFF; 7% TURN OFF LIST FLAG */ 
002500 BROSMEMB = BLANKS; 7® CLEAR SEL. MEMBER ¥*/ 
002600 END; /* */ 
002700 END; 7* */ 
002800 ELSE 7* ELSE CNOTHING SELECTED) ,*/ 






Figure 41. Edit - Profile Display 
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Hexadecimal Display 


When edit is operating in HEX mode, three lines are displayed for 
each source line. The first line shows the data in standard char- 
acter form. The following two lines show the same data in 
hexadecimal representation. See Figure 42. 


Any invalid Cnon-displayable) characters may be changed by over~- 
typing the hexadecimal representations. Any valid character may 
be changed by overtyping either the standard character represent-— 
ations or the hexadecimal representations. 


Note: The FIND and CHANGE commands may also be used to find and 
change invalid characters or any specific hex character, regard- 
less of the setting of HEX mode. See discussion of picture 
strings and hex strings under FIND and CHANGE commands. 


HEX mode may be turned on or off by using the HEX command. Format: 
HEX [ON/OFF] ([VERT/DATA] 


The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. 


The VERT (vertical) and DATA operands are valid only when HEX mode 
is turned on. VERT causes the hexadecimal representations to be 
displayed vertically (two rows per byte) under each character. 
DATA causes the hexadecimal representations to be displayed as a 
string of hex characters (two per byte), as shown in Figure 42. 
Since the hex string is twice as long as the data string, it con- 
sumes two rows. If this operand is omitted, VERT is the default. 


EDIT --- SPFDEMO.SAMPLE.PLI(BROPDS) - 01.02 COLUMNS 061 072 

COMMAND INPUT ===> _ SCROLL ===> HALF 

000700 ZINCLUDE SYSLIB(BROLISTM); 7% LIST MEMBER NAMES %/ 
40404040404040404040406CCSD5C 3D 3E4C4C540E2E8E2D3C9C24DC2D SD6D3C9E2E3D45D 
5E4040406 1504040404040D3C9E2E340D4C5D4C2C5D 940D5C 1D4C5E240404040405C6140 


; / 
40404040404040404005D5045E404.0404040404040404040404040404040404040404040 
404040406 1504040404040404040404040404040404040404040404040404040405C6 140 


7* ELSE; 
40404040404040C5D3E2C540404040404040404040404040404040404040404040404040 
404040406150404040C5D3E2C56B40404040404040404040404040404040404040506 140 


? 
404040404040404046004D65E40404.0404040404040404040404040404040404040404040 
404040406 1504040404040404040404040404040404040404040404040404040405C6 140 


BROMLIST = OFF; TURN OFF LIST FLAG 
4040404040404040404040C2D SD6D4D3C 9E2E 340 7E4006C6065E40404040404040404040 
404040406 15C4040404040E3E4D SD540D6C6C640D 3C9E2E340C6D3C107404040405C6140 


BROSMEMB = BROMMEMB; MOVE MEMBER NAME TO ¥/ 
4040404040404040404040C2DSD6E 2D4C5D4C2407E40C 2D SD6D4D4C5D4C25E 4040404040 
4040404606 1504040404040D4D6E5C540D4C5D4C2C5D 940D5C1D4C540E3D64040405C6140 


001300 ; 'SELECTED' MEMBER 
404040404040404040C5D5C45E4040404040404040404040404040404040404040404040 


Figure 42. Edit - Hexadecimal Display, Data 
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TEXT PREPARATION FEATURES 


The following commands are described in the section: 
Primary command: CAPS 


Line commands: TE Ctext entry) 
TS (text split) 
TF Ctext flow) 
0 Coverlay) 


Character Translation 


If CAPS mode is on; alphabetic data entered at the terminal is 
automatically translated to upper case during edit operations. 
If CAPS mode is off, alphabetic data is left "as is”. CAPS mode 
is normally on except when documentation (text) is being edited. 


CAPS mode also determines whether character strings, entered as 
operands of the FIND and CHANGE commands, are translated to upper 
case. Note that the keyword operands and all menu parameters are 
always translated to upper case regardless of the current setting 
of CAPS mode. 


CAPS mode may be turned on or off by using the CAPS command. 
Format: 


CAPS [ON/OFF] 


If the operand is omitted, ON is the default. 


Whenever data is fetched for editing, SPF will initialize the set- 
ting of CAPS mode based on whether the data does or does not con- 
tain lower case alphabetics. If the initial setting of CAPS mode 
differs from the previous setting in the profile, a message will 
be displayed indicating that edit has changed the mode. For new 
members or empty sequential data sets, the initial setting of CAPS 
mode is unchanged from whatever is in the profile. The default 
for a new profile is CAPS mode ON. 


Text Entry and Edit 


All of the edit line and primary commands may be used when enter- 
ing and editing text information. Three additional line commands 
are provided specifically for this purpose: 


TE - Text Entry 
TS - Text Split 
TF - Text Flow 


These commands are described in the following sections. 
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_ Text Entry 


The text entry command is intended for bulk entry of text using. 
power typing techniques. When the characters "TE" are entered in 
a line command area, blank lines are inserted starting with the 
line following the "TE". A number may follow the "TE" to indicate 
the number of blank lines to be inserted. If the number is omit- 
ted, sufficient blank lines are inserted to fill the screen from 
the line following the "TE" to the end of the screen. 


TE ~ Text entry Cto end of screen) 
TEn - Text entry "n" lines 


The user may type information on the blank lines without regard to 

line end. The line command area on the blank lines is protected, 
and automatic cursor skip is provided from the end of one line to 
the first data position on the next line. When the ENTER key is 
pressed, the new information is automatically reflowed to fit 
within the currently defined boundaries (see BOUNDS line 
command), and any unused blank lines at the end of the new text 
are deleted. 


If insufficient blank lines have been generated, the keyboard 
will lock when the user attempts to type beyond the last character 
position of the last blank line. A vertical bar (|) will be dis- 
played above the cursor at the locked position. To generate more 
blank lines, press the RESET key to unlock the keyboard and then 
press the ENTER key. 


Multiple paragraphs may be entered by using either of the follow- 
ing techniques: 


° leave a blank line between paragraphs, or 
° indent the start of a new paragraph with three or more blank 
(space) characters. 





Note: Tab definitions are not functional during text entry. 


Text Split 


The text split command allows insertion of new material into 
existing text. To split a line, enter the characters "TS" in a 
line command area and then move the cursor to the desired split 
point Con the same line) before pressing the ENTER key. A new 
line is inserted following the line containing the "TS". Text to 
the right of the cursor, up to and including the current right 
boundary column, is is moved to the next line (Cfollowing the 
inserted line) and positioned at the current left boundary col- 
umn. See BOUNDS line command for definition of boundary columns. 


A number may follow the "TS" to cause additional lines to be 
inserted. 


TS ~ Text split and insert line 
TSn - Text split and insert "n" lines 


Figure 43 shows a before-and-after example of line splitting, 
where "TS3" was entered on’ line 60 and the cursor was positioned 
following the word "text". 


Automatic cursor skip is not provided from the end of one line to 
the next when the "TS" command is used. The line command areas on 
the new line €s) are unprotected and may be used to enter line 
commands, as usual. 
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EDIT --- SPFDEMO SCRIPT C1 COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 


000056 
000057 
000058 
000059 
TS3 

000061 
000062 
000063 
000064 
000065 
000066 
000067 
000068 
000069 
000070 
000071 
000072 
000073 
000074 
000075 
000076 
000077 
006078 
000079 
000080 
000081 


CH6.TEXT SPLIT 


THE TEXT SPLIT COMMAND IS INTENDED FOR INSERTION OF NEW MATERIAL INTO 
EXISTING TEXT. _TO SPLIT A LINE, ENTER THE CHARACTERS "TS" IN A LINE 
COMMAND AREA AND THEN MOVE THE CURSOR TO THE DESIRED SPLIT POINT (ON THE 
SANE LINE) BEFORE PRESSING THE ENTER KEY. A NEW LINE IS INSERTED 
FOLLORING THE LINE CONTAINING THE "'TS'', AND ALL TEXT TO THE RIGHT OF THE 
CURSOR IS MOVED TO THE BEGINNING OF THE NEXT LINE (FOLLOWING THE 
INSERTED LINE). A NUMBER MAY FOLLOW THE "TS" TO CAUSE ADDITIONAL LINES 
TO BE INSERTED. 


-FO OFF 
-BX 9 72 
TS - TEXT SPLIT AND INSERT LINE 
TSN =~ TEXT SPLIT AND INSERT "N' LINES 
~-BX OFF 
-FO ON 


¢FIGREF REFID='ETS'. SHONS A BEFORE-AND-AFTER EXAMPLE OF LINE 
SPLITTING, WHERE "TS3"' WAS ENTERED ON LINE 60 AND THE CURSOR WAS 
POSITIONED FOLLOWING THE WORD "TEXT". 


AUTOMATIC CURSOR SKIP IS CHPI.NOTCEHP]. PROVIDED FROM THE END OF ONE 
LINE TO THE NEXT WHEN THE "TS'? COMMAND IS USED. THE LINE COMMAND AREAS 
ON THE NEW LINE(S) ARE UNPROTECTED AND MAY BE USED TO ENTER LINE 


EDIT --- SPFDEMO SCRIPT Cl COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 


000056 
000057 
000058 
000059 
000060 


000064 
000065 
000066 
000067 
000068 
000069 
000070 
000071 
000072 
000073 
000074 
000075 
000076 
000077 
000078 
000079 
000080 
000077 


Figure 


¢H6.TEXT SPLIT 


THE TEXT SPLIT COMMAND IS INTENDED FOR INSERTION OF NEW MATERIAL INTO 
EXISTING TEXT. _ 


TO SPLIT A LINE, ENTER THE CHARACTERS "TS" IN A LINE 

COMMAND AREA AND THEN MOVE THE CURSOR TO THE DESIRED SPLIT POINT (ON THE 
SAME LINE} BEFORE PRESSING THE ENTER KEY. A NEW LINE IS INSERTED 
FOLLOWING THE LINE CONTAINING THE "TS", AND ALL TEXT TO THE RIGHT OF THE 
CURSOR IS MOVED TO THE BEGINNING OF THE NEXT LINE (FOLLOWING THE 
INSERTED LINE). A NUMBER MAY FOLLOW THE “'TS" TO CAUSE ADDITIONAL LINES 
TO BE INSERTED. 


-FO OFF 
-BX 9 72 
TS - TEXT SPLIT AND INSERT LINE 
TSN =~ TEXT SPLIT AND INSERT "'N'' LINES 
-BX OFF 
-FO ON 


CFIGREF REFID='ETS‘'. SHOWS A BEFORE-AND~AFTER EXAMPLE OF LINE 
SPLITTING, RHERE "TS3"" RAS ENTERED ON LINE 60 AND THE CURSOR WAS 
POSITIONED FOLLOWING THE WORD "TEXT". 





43. Edit - Text Split Example 


Edit (Option 2) 93 


94 


The text split command may also be used in conjunction with other 
line commands to move or copy text. Use "TS" at the end points of 
the material to be moved or copied Ci.e., to break it out so that 
is is wholly contained on one or more lines). In addition, use 
"TS" at the insertion point to open up space. Then use the stand- 
ard move ("M" or "MM") or copy ("C" or "CC") Line command together 
with the after C'A™) or before ("BN") line command. 


Figure 44 shows an example of a sentence to be moved from one par- 
agraph to another. In the first part of the figure, the sentence 
on lines 33-35 has already been split out by using the "TS" com- 
mand twice (once with the cursor at the beginning of the sentence, 
and again at the end of the sentence). Another "TS" command is 
now entered on line 44 to split the second paragraph at the desti- 
nation point for the move. The second part of the figure shows 
the use of "MM" and "A" to accomplish the move. 
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EDIT --- SPFDEMO SCRIPT Cl COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 


000030 
000031 
000032 
000033 
000034 
000035 
pouueer 
000037 
000038 
000039 
000040 
000041 
000042 


THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 
END. 

THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 
DATA POSITION. ON THE NEXT LINE. 


WHEN THE ENTER KEY IS PRESSED, THE NEN 

INFORMATION IS AUTOMATICALLY REFLOWED TO FIT WITHIN THE CURRENTLY 
DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 
AT THE END OF THE NEW TEXT ARE DELETED. 


IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, THE KEYBOARD WILL LOCK 
WHEN THE USER ATTEMPTS TO TYPE BEYOND THE LAST CHARACTER POSITION OF THE 
LAST BLANK LINE. _A VERTICAL BAR (1) WILL BE DISPLAYED ABOVE THE CURSOR 


- AT THE LOCKED POSITION. TO GENERATE MORE BLANK LINES, PRESS THE RESET 


KEY TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER KEY. 


MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 
TECHNIQUES: 


cuL 

¢LI.LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 

¢LI.INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 
CHARACTERS. 

eEUL 


EDIT -~-- SPFDEMO SCRIPT Cl COLUMNS 001 072 
COMMAND INPUT === SCROLL ===> HALF 


600030 
000031 
000032 


000042 


AL 

000044 
000045 
000046 
000047 
009048 © 
000049 
000050 
000051 
000052 
000053 
000054 
000055 


THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 
END. 

THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 
DATA POSITION ON THE NEXT LINE. 

WHEN THE ENTER KEY IS PRESSED, THE NEW 

INFORMATION IS AUTOMATICALLY REFLOWED TO FIT WITHIN THE CURRENTLY 
DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 
AT THE END OF THE NEW TEXT ARE DELETED. 


IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, THE KEYBOARD WILL LOCK 
WHEN THE USER ATTEMPTS TO TYPE BEYOND THE LAST CHARACTER POSITION OF THE 
LAST BLANK LINE. 


A VERTICAL BAR (|) WILL BE DISPLAYED ABOVE THE CURSOR 
AT THE LOCKED FOSITION. TO GENERATE NORE BLANK LINES», PRESS THE RESET 
KEY TO UNLOCK THE KEYBOARD AND THEN eRESS THE ENTER KEY. 


MULTIPLE PARAGRAPHS MAY BE ENTERED BY ¥SING EITHER OF re FOLLOWING 
TECHNIQUES; 


CUL 

¢LI.LEAVE A BLANK LINE BETWEEN PARAGRAPHS OR 

¢LI.INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE ) 
CHARACTERS. 





Figure 44. Edit - Move Sentence Example 
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Text Flow 


The text flow command may be used to reflow paragraphs following 
deletions, insertions, splitting, etc. When the characters "TF" 
are entered in a line command area, the text is reflowed from the 
beginning of that line to the end of the paragraph. 





The reflow operation will remove trailing blanks ona Line by 
pulling in material from the following line. It will not, howev~ 
er, remove embedded blanks within a line. Accordingly, if one or 
more words in a line are to be deleted, the 3270 DELETE key should 
be used (rather than overtyping the words with blanks). 


The text to be flowed is taken from within the currently defined 
column boundaries (see BOUNDS line command). Any text outside the 
bounds does not participate in the flow operation. The reflowed 
text is also positioned within the current bounds. If the ori- 
ginal text was indented from the left boundary, the indentation is 
preserved. 


Each line of the reflowed text normally extends to the right 
boundary position. However, the text may be “squeezed up" by 
entering a number after the "TF" command. The number specifies 
the right-most column postion for the reflowed text. It must be 
less ik the current satting of the right bound Cotherwise, it is 
ignored). 


A before and after example of text flow is shown in Figure 45. 
The bounds are set at 1 and 72. A "TF50" command is entered on 
line 41. All text between 1 and 72 participates in the flow, but 
the results are contained within columns 1 and 50. 


Use of Program Function Keys for Text Commands 


96 


Whenever heavy use is being made of the text line commands, it is 
strongly recommended that both the text split and text flow com- 
mands be assigned to program function (PF) keys. For users of 
l2-key terminals, infrequently used PF keys such as Shift Right 
and Shift Left may be reassigned to these functions. Use SPF 
Parms Coption 0.3) to reassign the keys. Example: 


With these key definitions, a text split may be accomplished by 
moving the cursor to the desired split point (within a line) and 


‘pressing PF10. After the new material has been typed, PF11 may be 


pressed to reflow the text from the line containing the cursor to 
the end of the paragraph. 
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EDIT --- SPFDEMO SCRIPT Cl COLUMNS 001 072 
COMMAND INPUT ===> . SCROLL ===> HALF 
000030 

000031 THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 
000032 END. 

000033 THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

000034 AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 
000035 DATA POSITION ON THE NEXT LINE. 

000036 WHEN THE ENTER KEY IS PRESSED, THE NEW 

000037 INFORMATION IS AUTOMATICALLY REFLONED TO FIT WITHIN THE CURRENTLY 
000038 DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 
000039 AT THE END OF THE NEW TEXT ARE DELETED. 


IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, THE KEYBOARD WILL LOCK 
WHEN THE USER ATTEMPTS TO TYPE BEYOND THE LAST CHARACTER POSITION OF THE 
LAST BLANK LINE. A VERTICAL BAR ({) WILL BE DISPLAYED ABOVE THE CURSOR 
AT THE LOCKED POSITION. TO GENERATE MORE BLANK LINES, PRESS THE RESET 
KEY TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER KEY. 


MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 
TECHNIQUES: 


SUL 
¢LI.LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 
¢LI.INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 
CHARACTERS. 
¢EUL . 
000055 


EDIT --- SPFDEMO SCRIPT Cl COLUMNS 001 072 
COMMAND INPUT ===> SCROLL ===> HALF 
000030 ; 

000031 THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 
000032 END. ; 

000033 THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND_ 

000034 AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 
000035 DATA POSITION ON THE NEXT LINE. 

000036 KHEN THE ENTER KEY IS PRESSED, THE NEW 

000037 INFORMATION IS AUTOMATICALLY REFLOKED TO FIT WITHIN THE CURRENTLY 
000038 DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 
000039 AT THE END OF THE NEW TEXT ARE DELETED. 

600049 

Q00041 IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, 

600042 THE KEYBOARD WILL LOCK WHEN THE USER ATTEMPTS TO 

000043 TYPE BEYOND THE LAST CHARACTER POSITION OF THE 

000044 LAST BLANK LINE. A VERTICAL BAR (1) WILL BE 

000045 DISPLAYED ABOVE THE CURSCR AT THE LOCKED POSITION. 

000046 TO GENERATE MORE BLANK LINES, PRESS THE RESET KEY 

000047 TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER 

000048 KEY. 

000049 

000050 MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 
009051 TECHNIQUES: 

o000cs2 

000053 <UL 

C00054 ¢LI.LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 

000055 ¢LI.INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 





Figure 45. Edit - Text Flow Example 


Edit (Option 2) 97 


-Overlaying Lines 
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The overlay line C"0" or "00") command allows a list of items to 
be rearranged in multi-column (tabular) format. The overlay com- 


mand may be used with the move line C"M" or "MM") or copy line 
C"C"™ or "CC™) Line commands. It is used’ in place of the after 
CVA") command. 


The character "0" may be entered in a line command area to specify 
the line over which data is to be moved or copied. A number may 
follow the "0" to indicate the number of lines to be overlayed. A 
block of lines to be overlayed may be specified by entering "00" 
on the first and last lines of the block. 






0 ~ Overlay line 
On ~ Overlay "n" lines 
00 - Overlay block of lines 


-Blank characters in the receiving line(€s), specified with "0" or 


"OO", are overlayed with corresponding characters from the source 
line€s), specified with "M", "MM™, "C™, or "CC". Non-blank char- 
acters are not overlayed. 


Only those characters which are within the current column bounda- 
ries participate in the overlay operation (see description of 
BOUNDS command). . . 


The number of source and receiving lines need not be the same. If 
there are more receiving lines, the source lines are repeated 
until the receiving lines are used up. If there are more source 
lines, the extra source lines are ignored. 


Only data lines participate in the overlay operation. Special 
lines such as MASK, TABS, BOUNDS, and COLS are ignored as either = 
source or receiving lines. 


A before and after example of overlaying lines is shown in 
Figure 46. Generally, a list such as that shown in the figure 
would be maintained and edited as a single column (Cleft adjusted). 
Prior to the overlay, portions of the list would be right-shifted 
by the appropriate amounts to overlay in the multi-column format. 


SPF=VM Program Reference 4% sha — 


EDIT --- SPFDEVEL.PRM. SCRIPT(DEMO} - “OL. 00. St et rw St COLUMNS 001 072 


COMMAND INPUT ===> SCROLL ===> HALF 
000035 

> 00 GENERAL COMMANDS: 
000037 
000038  COLS 
000039 I, IN CINSERT) 
000040 D, DN, DD - (DELETE) 
000041 Ry» RN» RR» RRN (REPEAT) 
000042 M, MN, MM (MOVE } 
000043 C, CN, cc’ (COPY) 
000044 A (AFTER) 

>| 00 B (BEFORE ) 
000046 

» NM ADVANCED FEATURES: 
000048 
000049 MASK 
000050 <, <N, <<, <<N (DATA LEFT) 
000051 >) >Ny >>, >>N (DATA RIGHT) 
000052 ae Ph (> (Ny (C0, CON (COLUMNS LEFT) 
000053 ¥> JN» 335 JIN (COLUMNS RIGHT) 
000054 BOUNDS 
000055 


MM 


HKKHHHH iaiaiaiieielainiateieieiaiaieieieeteisininieioioie® BOTTOM OF DATA JER RBBB BBB RBBB BBHBE 


> 


EDIT --- SPFDEVEL.PRM.SCRIPT(DEMO} - 01.00 | COLUMNS 001 072 
COMMAND INPUT ===> - SCROLL ===> HALF 
000035 | _ 

000036 GENERAL COMMANDS: , ADVANCED FEATURES: 

000037 

000038  COLS | : | MASK 

000039 IN (INSERT) <, <Ny <<, <<N (DATA LEFT) 
000040 Ds DN, DD (DELETE) >) ON, >>) >>N (DATA RIGHT) 
000041 RN» RR» RRN (REPEAT) (> (Ns (Cs CCN (COLUMNS LEFT) 
000042 MN, MM (MOVE) }> YN» 23, JIN (COLUMNS RIGHT) 
000043 CN, CC (COPY } BOUNDS 

000044 (AFTER) 

000045 (BEFORE) 

000046 


HH IHIHIEN HII IH IIE IIE HIE IE HE HIE INES HIHHEHINEN BOTTOM OF DATA 263636363636 56 963696 6 56H IE IE HE IE TE SE IE HE IESE IE HEE IEE 


i 





Figure 46. Edit - Overlay Line Example 
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UTILITIES (OPTION 3) 


The utility option provides a variety of functions for SPF 
library and file maintenance, moving and copying data, printing 
or displaying SPF project listings, resetting SPF library statis- 
tics, initiating spool output, retrieving data from the virtual 
reader, retrieving SPF libraries (via tape) from a TSO system, and 
formatting SCRIPT/VS documentation. 


The utility selection menu is shown in Figure 47. 


1 LIBRARY LIBRARY UTILITY: 
PRINT INDEX LISTING OR ENTIRE FILE 
PRINT, RENAME, DELETE, OR BROWSE MEMBERS 
COMPRESS SPF LIBRARY OR CNS MACLIB 
FILE UTILITY: 

SPECIFY OR UNSPECIFY SPF LIBRARY 
DISPLAY SPF LIBRARY OR CMS FILE INFORMATION 
RENAME OR DELETE SPF LIBRARY OR CMS FILE 

MOVE/COPY ~ MOVE OR COPY MEMBERS OR FILES 

PROJECT PRINT OR DISPLAY SPF PROJECT LIBRARIES 

RESET RESET STATISTICS FOR MEMBERS OF SPF LIBRARY 

SPOOL INITIATE SPFCOL OUTPUT 

READER RETRIEVE BATCH OUTPUT FROM READER 

RETRIEVE RETRIEVE SPF/TSO LIBRARIES FROM TAPE . 

SCRIPT/VS - FORMAT, DISPLAY, AND OPTIONALLY PRINT SCRIPT TEXT 





Figure 47. Utility Selection Menu 


For each of the utility options, a panel is displayed that allows 
the user to select a function and enter the appropriate library or 
file information. These panels allow both option selection and 
data entry in a single panel format. 


The following describes each of the utility functions, corre- 
sponding to each option on the secondary menu. 
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LIBRARY UTILITY COPTION 3.1) 


When this option is selected, a panel is displayed that allows the 
user to specify a Library or file and indicate an action to be 
performed (Figure 48). Possible actions are: 


~ Compress SPF library or CMS MACLIB 
- Print index listing 
~ Print SPF library or CMS file 
- Print member 
~- Rename member 
- Delete member 
- Browse member 
lank - Display member list 


Note: The library utility is intended primarily for maintenance 
of SPF libraries, MACLIBs, and TXTLIBs, but the "print index list- 
ing” and “print SPF library or CMS file” functions also apply to 
sequential CMS files. 


LIBRARY UTILITY 
SELECT OPTION === 


C - COMPRESS SPF LIBRARY OR CMS MACLIB PRINT MEMBER 
X ~- PRINT INDEX LISTING RENAME MEMBER 
L - PRINT SPF LIBRARY OR CMS FILE DELETE MEMBER 
BLANK ~- DISPLAY MEMBER LIST BROWSE MEMBER 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER (IF OPTION "P", "R", "D", OR “BM SELECTED) 
NEWNAME (IF OPTION "R" SELECTED) 


CMS FILE: 
FILE ID 
MEMBER CIF OPTION "PP", "R™, "D', OR "BY" SELECTED) 
NERNAME (IF OPTION "R" SELECTED} 
‘KED, SPECIFY: 
OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD === UPDATE PASSWORD ===> 


Figure 48. Library Utility Panel 


If option "C" (compress SPF library or CMS MACLIB) is selected, 
any MACLIB Cincluding an SPF library with a MACLIB organization) 
may be specified. The compress is accomplished by invoking the 
MACLIB command. 


If option "X" Cprint index listing) is selected, any SPF library 
or CMS file may be specified. The index listing is recorded in 
the SPF list file. For SPF libraries, MACLIB's, and TXTLIBs, the 
index listing includes general information about the library fol- 
lowed by a member list. For a sequential CMS file, the index 
listing includes general information only. See Appendix C for an 
example of index listing format 
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If option "L"™. Cprint SPF library-or CMS file) is selected, any SPF 
library or CMS file may be specified. <A source Listing of the 
entire file. Cincluding all member's), “preceded by an index list- 


ing, is recorded in the SPF list file. 


If option biel sic (print meMbeR) is. welgcced: a member of any SPF 
library, MACLIB, or TXTLIB may be specified. A source listing of 
the member is recorded in the SPF list file. 


If. option "R" or option mpm Erenane member or delete member) is 


selected, a member of any SPF library, MACLIB, or TXTLIB may be. 
specified. A new member name. must also be Speer ties for the "re- 
name member" function. 


If option "B" CEnonse:. Senne is ‘selected, a member of any SPF 
library, MACLIB, or TXTLIB may be specified. The specified member 
will be displayed in browse mode. All browse commands can be exe- 
cuted. When browse is terminated by pressing the End PF key, the 
library utility panel will be redisplayed. 


If no option is specified (blank to display member listing), any 
SPF library, MACLIB, or TXTLIB may be specified. A member listing 
is then displayed from which the user may select members for 
printing, renaming, deleting, or browsing by entering "P", "R", 
wp", or "BY" respectively in front of one or more member names. For 
renaming, a new member name must also be entered in the field 
immediately following the current member name. The member list 
may be scrolled up and down via the scroll PF keys or via the 
LOCATE command. The member List may be terminated by pressing the 
End PF key. 


Figure 49 shows a before-and-after example where members) ACCT1 


and ACCT2 are printed, member UPDATE is deleted, and member 
LISTNEW is renamed LISTOUT. 


fe 
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UTILITIES --+ SPFDEMO.MYLIB.PLI 
COMMAND INPUT === 
RENAME VER.MOD CREATED 


NAME 
ACCOUNT 
ACCT1 
ACCT2 
COINS 
COMPX 
COMPY 
DCLS 
LISTNEW 
MAIN 
TESTDIR 


D UPDATE 


XX END HH 


NAME 
ACCOUNT 
ACCTI 
ACCT2 
COINS 
COMPX 
COMPY 
DCLS 


*PRINTED 


- ¥PRINTED 


LISTNEW *RENAMED 


MAIN 


TESTDIR 


UPDATE 
XX END 


*DELETED 


01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 
01.00 


01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.04 
01.00 


79/01/09 
79701709 
79701709 
79704724 
79/01/09 
79/01/14 
79704723 
79/04/23 
79/01/09 
79/04/23 
79701709 


UTILITIES --- SPFDEMO.MYLIB.PLI 
COMMAND INPUT ===> _ 
RENAME VER.MOD CREATED | 


79701709 
79/01/09 
79/01/09 
79/04/24 
79/01/09 
79701714 
79704723 
79/04/23 
79/01/09 
79/04/23 
79701709 


LAST MODIFIED 


79/01/09 
79/04/23 
79/01/99 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/05/06 
79/01/09 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
17:04 
17:08 


LAST MODIFIED SIZE 


79/01/09 
79/04/23 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/05/06 
79/01/09 


17:97 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
17:04 
17:08 


21 
99 
20 
19 
44 
13 
290 
17 

4 
30 
13 


SCROLL 


MOD 


-~ 
ococoroctloaoqnsc 


SCROLL 


MOD 


- 
oeoocorotooas 


Figure 49. Library Utility - Print, Rename, and Delete 
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MOSTON 
KLEIN 

MOSTON 
MOSTON 
MOSTON 


> PAGE 
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FILE UTILITY COPTION 3.2) 


When this option is selected, a panel is displayed that allows the 
user to specify a Library or file and indicate an action to be 
performed (Figure 50). Possible actions are: 


S - Specify new SPF library 

UY - Unspecify an SPF library 

R - Rename file or SPF library 

D - Delete ("erase") file or SPF library 

blank - Display file or SPF library information 


For options ng and “"U"™, an SPF library identification (project, 
library, and type) must be specified. For the other options, any 
SPF library or CMS file may be specified. 


OPTION ===> 


S$ - SPECIFY NEW SPF LIBRARY 

U - UNSPECIFY AN SPF LIBRARY 

R - RENAME SPF LIBRARY OR CMS FILE 

D - DELETE SPF LIBRARY OR CMS FILE 

BLANK - DISPLAY SPF LIBRARY OR CMS FILE INFORMATION 


SPF LIBRARY: 
PROJECT ===> SPFDEMO 
LIBRARY ===> MYLIB 
TYPE ===> PLI 


CMS FILE: 
FILENAME ===> 
IF NOT LINKED, SPECIFY: 
ORNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSNORD ===> UPDATE PASSWORD ===> 





Figure 50. File Utility Panel 


If option "S" (specify new SPF library) is selected, a panel is 
displayed to allow specification of SPF library attributes and 
location (minidisk), link access mode for update, and correspond- 
ing CMS filetype/filename (Figure 51). Default values are 
pre-entered based on what the user last entered, or based on the 
last "display file information” request (whichever occurred most 
recently). The user may overtype the displayed defaults. When the 
ENTER key is pressed, the new library is specified. Pressing the 
End PF key causes a return to the previous panel without perform- 
ing the library specification. 


If the specified library location is not the user's A-disk (191), 
SPF attempts to access the minidisk using the designated link 
access mode for update. This link will fail if the user specified 
mode "NW" and the minidisk is currently Linked. 


See Appendix B for guidelines in specifying SPF libraries. 
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SPECIFY NEW SPF LIBRARY 
SPF LIBRARY NAME: NEWPROJ.MASTER.ASSEMBLE 


SPF LIBRARY ATTRIBUTES: 
ORGANIZATION $ (Ss 
RECORD FORMAT F {F 
RECORD LENGTH 80 (1 


“SET OF FILES, M = MACLIB, T = TXTLIB) 
FIXED, V = VARIABLE) 
32767 BYTES) 


SPF LIBRARY LOCAT 
OWNER'S ID STEPHENS (BLANK FOR YOUR USERID) 
DEVICE ADDR. 5FE (BLANK FOR '191'°) 


LINK ACCESS MODE FOR UPDATE: 
MODE LETTERS ===> M_ (M, W, OR MW) 


FOR ORGANIZATION S (SET OF FILES): 
FILETYPE ===> (BLANK CAUSES SPF TO GENERATE A NAME) 


FOR ORGANIZATION M OR T (MACLIB OR TXTLIB): 
s==> 


FILENAME (BLANK CAUSES SPF TO GENERATE A NAME) 





Figure 51. File Utility - Specify New SPF Library 


If option "U" Cunspecify SPF library) is selected, a confirmation 
panel is displayed to ensure that the user did not select this 
option by mistake. As directed in the panel, the user must then 
press either the ENTER key to confirm or the End PF key to cancel. 
Either action causes a return to the previous panel. 


Option "U" causes the information about the SPF library to be 
purged from the SPF catalog, but it does not cause the associated 
filet€s) to be deleted. 


If option "R™ Crename file or SPF library) is selected, a panel is 
displayed to allow the user to enter the new file or SPF library 
identification (Figure 52). The user may type the new identifi- 
er€s) and press ENTER (to rename), or press the End PF key to 
cancel. Either action causes a return to the previous panel. 


If option "D" (delete file or SPF library) is selected, a confir- 
mation panel is displayed to ensure that the user did not select 
this option by mistake. As directed in the panel, the user must 
then press either the ENTER key to confirm or the End PF key to 
cancel. Either action causes a return to the previous panel. 


If an SPF library is specified, option "D" causes the library to 
be unspecified and the associated file(s) to be deleted (erased). 


If no option is specified (blank to display file or SPF library 
information), the location, characteristics, and current space 
utilization of the specified library or file are displayed 
(Figure 53). The user may return to the previous panel by pressing 
either the ENTER or End PF key. 
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ee wecerneccceona-= RENAME SPF. LIBRARY 
SPF LIBRARY NAME: SPFDEMO.XXX.COBOL 


SPF: LIBRARY LOCATION: 
OKNER'S ID: SPRINGER 
DEVICE ADDR: 195 


NEW SPF LIBRARY NAME: 
PROJECT ===> 
LIBRARY 
TYPE 





' Figure 52. File Utility - Rename SPF Library 


SPF LIBRARY INFORMATION 
“SPF LIBRARY NAME: SPFDEMO. MYLIB.PLI 


SPF LIBRARY ATTRIBUTES: 
ORGANIZATION: M (S = SET OF FILES, M = MACLIB, T = TXTLIB) 
RECORD FORMAT: F (F = FIXED, V = VARIABLE) 
RECORD LENGTH: 6&0 


SPF LIBRARY LOCATION: 
OXNER'S ID: STEPHENS 
DEVICE ADOR: SFE 


SPF LIBRARY ACCESSIBILITY: 
LINK ACCESS MODE FOR UPDATE: MW 


EQUIVALENT FILE DATA: 
CMS FILE ID: DEMOPLI MACLIB 





Figure 53. File Utility - Display Information 
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MOVE/COPY UTILITY COPTION 3.3) 


When this option is selected, a panel is displayed that allows the 
user to specify the "from" library or file Cand member if it is an 
SPF library, MACLIB, or TXTLIB), and to indicate an action to be 
performed (Figure 54 top). Possible actions are: 


CP - Copy file or member(s) and print 
MP - Move file or member(s) and print 
C - Copy without printing 
M - Move without printing 


When ENTER is pressed, a second panel is displayed that allows the 
user to specify the "to" library or file (Figure 54 bottom). The 
following options must also be specified on this panel: 


° Replace like-named members CYES or NO), if the "to" file is an 
SPF library, MACLIB, or TXTLIB. 


° "To" CMS file disposition COLD or MOD), if the "to" file is 
sequential. 


A disposition of OLD causes an existing file to be rewritten. A 
disposition of MOD causes the "from" data to be appended to the 
end of an existing "to" file. 


Any SPF library or CMS file may be specified for either the "from" 
or "to" file, but the same SPF library, MACLIB, or TXTLIB may not 
be specified as both the "from" and "to" file. 


If the "to" file is a CMS file which does not currently. exist, a 
new file will be created with the same attributes as the "from" 
file. If the "to" file is an SPF library, it must have been pre- 
viously specified via option 3.2 (specify SPF library). 


If "move”™ is indicated and the "from" file is an SPF library, 
MACLIB, or TXTLIB, the selected member(s) will be deleted in the 
"from" file after they have been successfully copied to the "to" 
file. If "move" is indicated and the "from" file is a sequential 
CMS file, the entire "from”™ file will be deleted after its con- 
tents have been successfully copied to the "to" file. If "copy" 
is indicated, no deletions will occur. 


If "print" is indicated for either move or copy, source listing(s) 
will be recorded in the SPF list file. If the "to" file is an SPF 
library, MACLIB, or TXTLIB, a listing of each new or replaced mem- 
ber will be recorded. If the "to" file is a sequential CMS file, a 
listing of its entire contents will be recorded after the informa~ 
tion has been successfully copied. 


The following rules apply for specifying member names if the 
"from" file is an SPF library, MACLIB, or TXTLIB: 


e Specifying a valid "from" member name causes a single member 
to be moved or copied. 


° Leaving the "from" menber name blank causes a member listing 
to be displayed (after the second panel has been displayed). 


e Specifying a "from" member name of asterisk (*) causes all 
members to be moved or copied. 


If the "to" file is an SPF library or MACLIB, the "to™ member name 
must be specified for the following conditions: 


° The "from" file is a sequential CMS file. 


° A single member is to be moved or copied and the member is to 
be renamed in the "to" file. (Members may also be renamed 
from a member listing ~~ see next paragraph. ) 


In all other cases, the Who hember should be Left blank. 
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SELECT OPTION ===> C 


CP ~ COPY FILE OR MEMBER(S) AND PRINT C - COPY WITHOUT PRINT 
MP - MOVE FILE OR MEMBER(S) AND PRINT M - MOVE WITHOUT PRINT 


SPECIFY "FROM" FILE BELOW, THEN PRESS ENTER TO SPECIFY "TO" FILE 


FROM SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER (BLANK FOR MEMBER LIST, * FOR ALL MEMBERS) 


FROM CMS FILE: 
FILE ID ===> 
MEMBER ===>> (FOR MACLIB OR TXTLIB) 
IF NOT LINKED, SPECIFY: © : 
OKNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD Sa? UPDATE PASSWORD ===> 


COPY. --- FROM SPFDEMO.MYLIB.PLI(*) 
SPECIFY "TO" FILE BELON 


TO SPF LIBRARY : 
PROJECT ===> SPFDEMO 
LIBRARY ===> MASTER_ 

TYPE ===> PLI 


CMS FILE FOR NEW CMS FILE: 
FILE ID ===> RECFM ===> 
MEMBER ===> LRECL ===> 

IF NOT LINKED, SPECIFY: 

OWNER'S ID === DEVICE ADDR. ===> LINK ACCESS MODE ===> 


(F OR V) 


UPDATE PASSWORD ===> 


REPLACE LIKE-NAMED MEMBERS ===> YES (YES OR NO) 


"TO" CMS FILE DISPOSITION > OLD (OLD OR MOD) 





Figure 54. Move/Copy Utility Panels 
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A member listing is displayed when the "from" file is an SPF 
library, MACLIB, or TXTLIB, and the "from" member name is left 
blank. The user may select members to be moved or copied by 
entering an "S" in front of one or more member names. The options 
for move or copy, and print or no print must have been previously 
specified on the first move/copy panel. If the "to" file is an SPF 
library or MACLIB, the member(s) may also be renamed by entering a 
new member name in the field immediately following the current 
name. 


The member List may be scrolled up and down via the Scroll PF keys 
or via the LOCATE command. The member list may be terminated by 
pressing the End PF key, which causes a return to the first 
move/copy panel. 


Figure 55 shows a before-and-after example where members ACCOUNT, 
ACCT1, ACCT2, and COMPY are copied to another library, aie member 
COMPY is also renamed ZCOMP. 


For any wovEsesos operation, the following rules apply. 


e If the "to" file is sequential, its entire contents are 
replaced (Cif disposition OLD was specified) or the new infor- 
mation is added to the end Cif disposition MOD was specified). 


e Multiple members of an SPF library, MACLIB, or TXTLIB may be 
moved or copied to a sequential CMS file by using a member 
selection list or by specifying all members (%). The merged 
members appear in the "to" file, replacing the original con- 
tents of the file Cif disposition OLD was specified) or added 
to the end Cif disposition MOD was specified). 


e If the "to" file is an SPF library, MACLIB, or TXTLIB, new 
members are added except when the member names are alike; 
like-named members are replaced (Cif replace YES was speci- 
fied) or not copied Cif replace NO was specified). 


° Record formats and logical record lenaths for the two files 
need not be alike. When necessary, data will be truncated or 
TI aa with blanks to accommodate different record 
engths. 


° The data to be moved or copied is not renumbered or modified 
in any way, except for possible truncation or padding as noted 
above. Printer control characters, if present, are treated 
as part of the data. 


e SPF library statistics are not modified when moving or copy- 
ing between SPF libraries. 


If the "to" file is a TXTLIB Cregardless of whether it is speci- 
fied as an SPF library or a CMS file), SPF invokes the CMS TXTLIB 
command to update the file. The member name in the TXTLIB is 
determined by the TXTLIB command, based on information in the text 
module. The user may not specify a member name (when moving or 
copying from a sequential TEXT file) nor rename the member Cwhen 
moving or copying from a TXTLIB). Any attempt to do so is ignored. 
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COPY ~-- FROM SPFDEMO.MYLIB.PLI TO 


COMMAND INPUT === 
RENAME VER.MOD CREATE 


NAME 
S ACCOUNT 
$S ACCT1 
S ACCT2 
COINS 
COMPX 
S$ COMPY 
DCLS 
LISTOUT 
MAIN 
TESTDIR 
XX END HH 


NAME 
ACCCUNT 
AccTl 
ACCT2 
COINS 
COMPX 
COMPY 
DCLS 
LISTOUT 
MAIN 
TESTDIR 
¥XEND 


COMMAND INPUT ===> 


01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 


79/01/09 
79/01/09 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/04/23 


RENAME VER.MOD CREATED 


*¥COPIED 
*COPIED 
*COPIED 


*COPIED 


01.00 
01.01 
01.00 
01.04 
61.00 
01.01 
01.00 
01.02 
01.00 
01.02 
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79/01/09 
79/01/99 
79/01/09 
79/04/24 
79/01/09 
79701714 
79704723 
79/04/23 
79701/09 
79/04/23 


SPFDEMO.MASTER.PLI 


LAST MODIFIED 


79/01/09 
79704723 


79701709 
79704724 


79/01/09 
79/01/14 
79/04/23 
79/04/23 
79701/09 
79/05/06 


17:07 
14:52 


17:07. 


16:20 
17:08 


12:30 
15:14. 


15:60 


17:08 > 


17:04 


LAST MODIFIED 


79/01/09 
79/04/23 
79701709 
79/04/24 
79/01/09 
79/01714 
79/04/723 
79/04/23 
79/01/09 
79/05/06 


17:07 
14:52 
17:07 
16:20 
17:08 
12:30 
15:14 
15:00 
17:08 
17:04 


SCROLL 


===> PAGE 


“MOD 


-_ 


SCROLL 
MO 


i 


Figure 55. Move/Copy Utility - Copy Members from List 


Ooec oro hace 


D 


eaoncorofac]da 


MOSTON 
KLEIN 

MOSTON 
MOSTON 


COPY --- FROM SPFDEMO.MYLIB.PLI TO SPFDEMO.MASTER.PLI -------------~- os 


> PAGE 


MCSTON 
KLEIN 

MOSTON 
MOSTON 





PROJECT UTILITY COPTION 3.4%) 


When this option is selected, a panel is displayed that allows the 
user to specify parameters for an SPF library and an action to be 
performed (Figure 56). Possible actions are: 


=> 


- Print project entries 
Stank ~ Display project entries 


Information may be requested for: 


e All SPF libraries known to the system, by specifying an aster- 
isk (%) for the project name. 


° All SPF libraries with a given project name, by specifying the 
project name and leaving the library name blank. 


° All SPF libraries with a given project and library name. 


If option "P™ (print project entries) is selected, a project list- 
ing 18s recorded in the SPF list file. The listing contains CMS 
file identifications, locations, and file characteristics for 
each SPF library with the specified project name. 


If no option its specified (blank to display project entries), a 
project listing is displayed at the terminal in browse mode. The 
listing may be scrolled up and down via the Scroll PF keys. All 
browse commands may be entered. The listing may be terminated by 
pressing the End PF key, causing a return to the previous panel 


Figure 57 shows an example of an SPF project listing. 


Mh SELECT OPTION === 


P - PRINT PROJECT ENTRIES 
BLANK - DISPLAY PROJECT ENTRIES 


SPF LIBRARY NAME: 
PROJECT ===> SPFDEVEL_ { * FOR ALL PROJECTS) 
===> (BLANK CAUSES ALL LIBRARIES TO BE PROCESSED) 


LIBRARY 





Figure 56. SPF Project Utility Panel 
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PROJECT LISTING FOR SPFDEVEL LINE 00001 COLS 001 080 
COMMAND INPUT ===> _ SCROLL ===> PAGE 
JB BEEBE EEOC TOP OF DATA 3€369696969696369696969696969696960005-CAPS ON-%% 
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SPF LIBRARY NAME 


SPFDEVEL .CVLOTPLS.PLI 
SPFDEVEL.CV1LOTTXT. TEXT 
SPFDEVEL.6032779.MSGS 
SPFDEVEL.G033079.MSGS 
SPFDEVEL.G041279.MSGS 
SPFDEVEL.JACK.ASM 
SPFDEVEL. JACK .COBOL 
SPFDEVEL. JACK. TEST 
SPFDEVEL. JACK. TEXT 
SPFDEVEL.JAS.PLI 
SPFDEVEL.KLEIN.PLI 
SPFDEVEL.MOSTON.PLI 
SPFDEVEL.MOSTON. TEXT 
SPFDEVEL .M032779..MENUS 
SPFDEVEL.M033079.MENUS 
SPFDEVEL.M0461279.MENUS 
SPFDEVEL.ORR.EXEC 
SPFDEVEL.ORR.MAC 
SPFDEVEL.P032779.PLI 
SPFDEVEL.T3GIN.SCRIPT 
SPFDEVEL.T3IGC.SCRIPT 
SPFDEVEL.T3PLM.SCRIPT 


| SPFDEVEL.T3PRM.SCRIPT 


FILENAME 


CV1OTPLI 


‘CVIOTTXT 


SPFO002M 
SPF0O003M 
SPFO00GN - 


M032779 
4033079 
M041279 
% 
ORRMAC 


SPFOOOIM 
x 


* 
* 
% 


FILETYPE 


MACLIB 
TXTLIB 
MACLIB 
MACLIB 
MACLIB 
ASSEMBLE 
COBOL 
SEQ 
TEXT 
PLI 

PLI 

PLI 
TEXT 
MACLIB 
MACLIB 
MACLIB 
EXEC 
MACLIB 
MACLIB 
SCRIPT 
SCRIPT1 
SCRIPT2 
SCRIPTS 


USER ID 


STEPHENS 
STEPHENS 
ORR 

ORR 

ORR 

COSTELLO 
COSTELLO 
COSTELLO 
COSTELLO 
STEPHENS 


KLEIN 


MOSTON 
MOSTON 
ORR 
ORR 
ORR 
ORR 
ORR 
PAQUETTE 
JOSLIN 
JOSLIN 
JOSLIN 
JOSLIN 


VDA RECFM LRECL ORG AM 


193 
193 
191 
191 
191 
191 
191 
191 
191 
191 
191 
191 
191 
191 
191 
191 
191] 
19] 
191 
194 
194 
194 
194 


<< <CCOHM TN CTNANAUNAAHA ANT ATAA AHH 
HHAWNZIAnHteTFIZouvynanvnnsrwaais 





Figure 57. SPF Project Utility - Sample Listing 
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RESET SPF STATISTICS UTILITY (OPTION 3.5) 


When this option is specified, a panel is displayed that allows 
the user to create, update, or delete SPF statistics and to reset 
sequence numbers (Figure 58). The reset utility handles only SPF 
libraries. Refer to the section entitled "SPF Library Statistics" 
for a discussion of the type of information maintained for each 
member of an SPF library. 


There are three valid options for this utility: 


R - Create/update statistics, conditionally reset sequence 
numbers 

N - Create/update statistics, no reset of sequence numbers 

D - Delete SPF statistics 


RESET SPF STATISTICS 
SELECT OPTION ===> R 


R - CREATE/UPDATE SPF STATISTICS, CONDITIONALLY RESET SEQUENCE NUMBERS 
N - CREATE/UPDATE SPF STATISTICS, NO RESET OF SEQUENCE NUMBERS 
D - DELETE SPF STATISTICS 


==> 2 (REQUIRED FOR OPTION R) 
==> XXXXXXX CIF USER ID IS TO BE CHANGED) 


NEW VERSION NUMBER = 
NEW CMS USER ID = 


SPF LIBRARY: 
SPFDEMO 
XXX 


LIBRARY 
COBOL 
* 


TYPE 
MENSER 


VvVvVvVY 


(BLANK FOR MEMBER LIST, * FOR ALL MEMBERS) 


UPDATE PASSWORD ===> 


Figure 58. Reset Utility Panel 


The "R® option is used to either create SPF statistics in a 
library that does not currently have them, or to update SPF sta- 
tistics in a library. The data is scanned to determine if valid, 
ascending sequence numbers are present in all records. If so, the 
data is renumbered and the modification level flags (the last two 
digits of each sequence number) are set to zeros. If valid 
sequence numbers are not present, renumbering is not done. 


The "N"™ option is also used to create or update SPF statistics as 
in option "R"™; however the data is not renumbered. This option 
should be used if the data already contains SPF statistics and the 
user wants to update the user id and/or version information with- 
out renumbering the data. 


The "D" option is used to delete SPF statistics. 
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The version number field is required for option "R", optional for 
option "N", and ignored for option "D". If option "N" is selected 
and a member without SPF statistics is selected, the statistics 
are created as if the version had been specified as "1". Ifa 
version number is specified, the statistics are created or reset 
as follows: 


Version number: set to the specified value 
Modification level: set to zero 

Creation date: set to current date 

Date/time last modified: set to current date and time 
Current number of lines: set to the current number of lines 
Initial number lines: set to the current number of lines 


Number of modified lines: set to zero 


The user id field is optional for options "R™ or "N"®; jit is 
ignored for option "D". If a user id is specified, it will be 
placed in the user id field of the SPF statistics. If the user id 
is left blank and a member without SPF statistics is selected, the 
GaanenS field of the statistics will be set to the current user 
id. 


The rules for specifying member names are as follows: 


° Specifying a valid member name causes the statistics to be 
. created or updated for a single member. 


« Leaving the member name blank causes a member listing to be 
displayed. 
e Specifying a member name of asterisk (*) causes the statis- 


tics to be created or updated for all members in the library. 


If a member listing is requested, the user may select members to 
be reset by entering an "S" in front of one or more member names. 
The member list may be scrolled up and down via the Scroll PF keys 
or via the LOCATE command. The member list may be terminated by 
ee eaune the End PF key, which causes a return to the reset utili-~ 
y panel. 
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SPOOL UTILITY COPTION 3.6) 


When this option is selected, a panel is displayed that allows the 
user to specify a library or file and indicate an action to be 
performed (Figure 59). 


Possible actions are: 


PR - Print 

PH - Punch with header 

PJ - Punch job (no header) 
DD - Disk dump 

XM -- Transmit 


Note: The SPF list and log files may not be specified; they may 
only be printed upon SPF termination. 





SPOOL UTILITY 
SELECT OPTION ===> PR 


PR - PRINT PJ - PUNCH JOB (NO HEADER) 
PH - PUNCH WITH HEADER DD - DISK DUMP 

XM = TRANSMIT SPF LIBRARY OR FILE 

SPF LIBRARY: 

PROJECT 
LIBRARY 
TYPE 
MEMBER 


“HoH au 
“MMV 


(* FOR ALL MEMBERS) 


CMS FILE: 
FILE ID = 


== Bean LISTING_ 
MENBER ==> - (% FOR ALL MACLIB/TXTLIB MEMBERS) 
IF NOT LINKED, SPECIFY: . 
OXNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD ===> 
SPOOL INFORMATION: 


USER/MACHINE ID | OTHER PARMS ===> NO CYES OR NO) 
NODE/LINK ID 





Figure 59. Spool Utility - First Panel 


Option "PR" Cprint) is used to print a listing file. 


The following options may be used to send data to another CMS 
user: 


e Option "DD" (disk dump) for any CMS file. 


° Option "PH" Cpunch with header) for any CMS file that has a 
record length of 80 or less. 


° Option "XM" Ctransmit) for any CMS file or an entire SPF 
library Cincluding library statistics). 


Option "PJ" Cpunch job) is used to send a file to another machine 


for job execution (may be used for sending CMS jobs to a CMS batch 
machine, or JCL to a VS or DOS/VSE machine). 
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An asterisk (%) may be entered in the member name field to process 
all members of an SPF library, or a CMS MACLIB or TXTLIB. 


The spool utility panel also allows the user to specify: 


° User/machine id - if the data is to be spooled to the virtual 
reader of another user or machine. 


° Node/link id - if the other virtual machine is at a remote 
location on the network. 


° Other parms (yes/no) - to allow specification of additional 
parameters and options. 


When the user enters the desired information, a second panel will 
be displayed if “other parms - yes" was specified on the first 
panel. Information entered on the second panel during previous 
uses of this utility is remembered and automatically redisplayed. 

This excludes "“user/machine id” and "node/link id™ which are sim- 
ply copied from the first panel, but may be modified on the second 
panel. 


For all options except "XM" (transmit), the following information 
may be entered on the second panel. See Figure 60. 


® Print command options ~ if option "PR" was. specified. See 
description of PRINT command in VM/SP CMS Command and Macro 
Reference, $C€19-6209. 


e Number of copies - if more than one copy is desired. 

e Spool class - for other than class A. 

e a number ~- for other than than the user's default destina-~ 
jon. 

° ‘For’ user - to spool the output to another user's virtual 


printer on the same VM system Cignored if either 
"user/machine id™ or "node/link id™ is specified). 


° 3800 keywords - if output is directed to an IBM 3800 printer 
which is attached to the CMS system as a virtual spooling 
device. See description of SPOOL command in VM/SP CP Command 
Reference for General Users, $C€19-6211. 


° User/machine id - to spool the output to the virtual reader of 
another user or machine. 


° Node/link id ~- if the desination is a remote node on the net- 


work (valid with either "user/machine id™ or "tag text", but 
not both). 


° Tag text - to specify control parameters for printing on a 
remote non-VM system. See description of TAG command in 


VM7370 RSCS Networking Program Reference and Operations 
Manual, SH24-5005. 


For option "XM" Ctransmit), the following information may be 
entered on the second panel. 


° Return acknowledgment Cyes/no) - "yes" causes automatic gen- 
eration of an acknowledgment message from the receiving 
user/machine. (The default is "yes" if the second panel is 
not displayed.) : 


° User/machine id ~ to spool the output to the virtual reader of 


another user or machine. (This parameter is required for 
option "XM". ) 


° Node/ Link id - if the desination user/machine is at a remote 
node on the network. 


If "other parms - no" was specified on the first panel, the second 
panel is not displayed and the remembered information is not used. 
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SPF generates the appropriate command (e.g., PRINT, PUNCH, DISK 
DUMP), depending on the option selected, to spool the data to the 
specified desination. The first panel is then redisplayed to 
allow specification of additional data to be spooled. When the 
End PF key is pressed from the first panel, the spool file is 
closed (releasing the data for output) and the user is returned to 
the next higher-level panel. 


Caution: . Erroneous results may occur if this utility is used in 
split screen mode while printer or. punch output is also being 
generated from the other logical screen. Output from the two log- 
ical screens may be intermingled on the virtual printer or punch 
if the user jumps back and forth between the screens. 


SPOOL FILE: MYPROG LISTING 

SPECIFY PARAMETERS: 

PRINT COMMAND “OFT ICNS 

SPOOL OPTIONS: 
NUMBER OF COPIES SPOOL CLASS = 
BIN NUNBER "FOR' USER = 
3800 KEYWORDS CHARS TN FLASH ABCD MODIFY X1 


>A 
> 


23, 


FOR SPOOLING TO ANOTHER PERSON OR MACHINE: 
USER/MACHINE ID 
NODE/LINK ID 
“JAG TEXT 


Figure 60. Spool Utility - Second Panel 
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READER UTILITY COPTION 3.7) 


The reader utility allows the user to retrieve files from his vir- 
tual reader, including output (TEXT files, LISTING files, etc.) 
% produced by the CMS batch machine as a upesule or SPF batch proc” 
oe _. essing Coption 5). 


The options displayed by ‘this utility are deuendene upon the sta~ 
tus and characteristics of the first active file on the user's 
virtual reader. 


For a TEXT file SKoduced by eh SPF batch csupile or assembly 
Coption 5) for which the source was from an SPF library, the 
options are: 


D - Delete reader file 
R - Read file onto A-disk . 
I - Insert batch output TEXT in SPF ‘library 


An example of this panel i= Shon: in Figure 61. The default 
option in this case is "I" (Cpre-entered on the panel). If option 
"I" is used, the user must specify an update password if the SPF 
TEXT library Cinto which the file is to be. inserted) 1S on a pass~ 
word protected minidisk. 


If the user Salcces: oot con eee Sol ieuias additional informa- 
tion may be specified: 


® Replace like-named file Cyes/no) - where "no" prevents a file 
with the same filename and filetype on the user's A-disk from 
being overwritten. 


® Rename to nev file id - which allows the file in the virtual 
Ard sk to be renamed in the process of moving it to the user's 
A- isk. 


READER UNLLETY: -Seeeee secede cea 
NEXT FILE ON YOUR READER IS: MEMBERL TEXT. . 


SELECT OPTION ===> I 


D - DELETE READER FILE 

R - READ FILE ONTO A-DISK 

I - INSERT BATCH OUTPUT TEXT IN SPF ET BRARS: SEE RRENGe neS TON TEXT 
UPDATE PASSWORD ===> — 


FOR OPTION R: 
REPLACE LIKE-NAMED FILE CYES OR NO) 
RENAME TO NEW FILE ID .COPTIONAL ) 





Figure 61. Reader Utility Panel 
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When the user selects an option and presses the ENTER key, the 
first file on the user's virtual reader is processed. SPF then 
examines the next file on the reader and redisplays the reader 
utility panel with options that are appropriate for the file. 


All variations of the reader utility panel include the "D" (de- 
lete) and "R" Cread) options. When the "R"™ option is selected, 
SPF issues a CMS command, such as READCARD or DISK LOAD, appropri- 
ate for the file being processed. 


The other panels displayed by this utility are similar to the one 
shown in Figure 61, except as follows: 


1. If the first file on the reader is not a TEXT file for whieh 
the source was from an SPF library, the "I" option Cand asso- 
ciated password field) will not be displayed. 


2. If the first file on the reader is a transmitted file (sent 
via the "XM" option of the spool utility), the following addi- 
tional option will be displayed: 


< - Ct 
7) wet 


The SPF library identification fields (project, library, and 
type) are prefilled with the library identification as it 
appears in the reader. The user may change this information to 
assign a new library identification. See Figure 62 top 


If option "S" jis selected and the SPF library does not cur- 
rently exist, a second panel is displayed to allow speci fica- 
tion of SPF library attributes (Figure 62 bottom). 


If option "S" is selected and the library does exist, a con- 
firmation panel is displayed with a warning that incoming 
members will replace like~named members in the existing 
library. As directed in the confirmation panel, the user may 
then press ENTER to continue or press the End PF key to can~ 
cel. 


3. If the first file on the reader is an acknowledgment from a 
transmit, the following additional option will be displayed: 


L -~ Log message in MAIL LOG file 


This option causes the message to be added to the end of file 
"MAIL LOG A* on the user's A-disk. If such a file does not 
currently exist, it is created. 


4. If the reader is empty, or if the first file in the reader 
cannot be processed by this utility, one of the following mes- 
sages is displayed on the second line of the panel: 


NEXT FILE ON YOUR READER IS: READER IS EMPTY 
NEXT FILE GN YOUR READER IS: NOT-CLASS A FILE 
NEXT FILE ON YOUR READER IS: FILE IN HOLD STATUS 


In these cases, the only option is to return to the previous 
panel by pressing either the ENTER key or the End PF key. For 
files which are not class A or which are in hold status, a CMS 
command may be entered Cunder SPF option 6) to change the 
class or status. This utility may then be reselected to con- 
tinue processing the virtual reader. 
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READER UTILITY 
NEXT FILE ON YOUR READER IS:. Z77EPO.DEMO.SCRIPT FROM: DPMG2 2Z77EPO 


SELECT OPTION ===> $ 


D ~ DELETE READER FILE 
S - STORE INTO SPF LIBRARY 
R - READ FILE TO A-DISK 


FOR OPTION R: 
SPECIFY CMS FILE ID (A-DISK ONLY) 
REPLACE LIKE-NANED FILE (YES OR NO) 


FOR OPTION S, SPECIFY SPF LIBRARY NAME: 
PROJECT 
LIBRARY 
TYPE 

UPDATE PASSWORD ===> 


PRESS END KEY TO EXIT WITH NO ACTION. 


RECEIVE AS SPF LIBRARY: SPFDEVEL.DEMO.SCRIPT 
RECFM: V LRECL: 120 


SPECIFY LIBRARY ATTRIBUTES: 
CRGANIZATION 
OWNER'S ID 
DEVICE ADDR. 
LINK ACCESS MODE 
CNS FILETYPE 
CNS FILENAME 


(S = SET OF FILES, M = MACLIB, T = TXTLIB) 
(BLANK FOR YOUR USERID) 

(BLANK FOR '191°)} 

(SPECIFY M, W, OR MW FOR UPDATE ACCESS) 

(ORG S3 BLANK FOR SPF-ASSIGNED FILETYPE) 

CORG M OR T3 BLANK FOR SPF-ASSIGNED FILENAME) 


( 
{ 
' 
Vv 
oO 


= 


wut aa 

ou ow out 

Hom mom ted 
VVVVv 


Vv 





Figure 62. Reader Utility - Receiving SPF Libraries 
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RETRIEVE UTILITY COPTION 3.8) 


When this option is selected, a panel is displayed that allows the 
user to specify a tape unit and serial number to retrieve SPF 
libraries (via tape) from a TSO system (Figure 63). The tape 
drive should be attached to the user's machine and readied before 
this utility is used. 


This utility has the following options: 


1 - Retrieve all SPF libraries on the input tape 
2 ~ Retrieve selected SPF libraries from the input tape 


The tape must be a standard labeled tape created by the IEHMOVE 
utility. Any SPF/TSO library (partitioned data set with a 3-level 
name) with fixed or variable record format can be processed. SPF 
library statistics are also retrieved during the processing. 


Note: This utility may not be used to place members into an 
SPF/CMS TEXT library with organization nq CTXTLIB). 


When the end of tape is reached, or the End or Return PF key is 
pressed, the tape is rewound but not unloaded. 


SELECT OPTION ===> 


1 - RETRIEVE ALL SPF LIBRARIES ON THE INPUT TAPE 
2 - RETRIEVE SELECTED SPF LIBRARIES FROM THE INPUT TAPE 


(MOUNT AND READY TAPE BEFORE PRESSING ENTER) 


u 
ul 
Lt 
Vv 


TAPE SERIAL 


TAPE UNIT ===> (181, 182, 183, OR 184) 


IF OPTION "1' IS SELECTED: 
- THE LIBRARIES MUST HAVE BEEN SPECIFIED VIA OPTION 3.2 
~ LIKE-NAMED MEMBERS ARE REPLACED, OTHER MEMBERS ARE ADDED 


Figure 63. Retrieve Utility Panel 


Retrieve All Libraries 


For option "1" the libraries must have been previously specified 
to SPF/CMS via utility 3.2 ("specify™ option). Project name, 
library name, and type for each SPF library on tape must exactly 
match an SPF/CMS library. Tape libraries for which no match is 
found are skipped. 
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The record length of the receiving library must be equal to or 
greater than that of the tape library, and the record formats must 
agree. Blocked record formats are accepted. 


The receiving library may be empty, or it may already contain mem- 
bers. AS members are copied from the tape into the specified 
library, new members are added and like-named members are 
replaced. : 


Retrieve Selected Ciiperics 
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For option "2" the identification of each SPF library encountered 
on tape may be reviewed at the terminal as the tape is read. The 
user may then choose to retrieve the library, skip to the next 
library on the tape, or search the tape for a specified library. 
Optionally, a library may be renamed as it is retrieved. 


If a library has not been previously specified to SPF/CMS, its 
characteristics may be specified during the retrieval process. 
For libraries which have already been specified, the rules for 
record format and length are the same as for option "1", but the 
replacement of like-named members is under user control. 


Either of two secondary panels is displayed for each library read 
from tape (see Figure 64). The first panel shown in the figure 1s 
displayed if the library is already specified to SPF/CMS. The user 
then has the following options: 


M-~- Merge members from tape with the specified SPF/CMS library. 
For this option, the user must specify the yes/no option for 
replacement of like-named members. (The library may be spec- 
ified and empty. ) 


I - Identify a new library name Crename option). For this option, 
the desired library identification (Cproject name, library 
name, and type) must be entered. If the designated library 
already exists, the first panel shown in Figure 64 is 
redisplayed. Normally, the user would then select option "M", 
If the designated library does not exist, the second panel 
shown in Figure 64 is displayed. Normally, the user would 
then select option "C" and enter the library attributes (see 
description of option "C* below). 


S - Skip to the next library on the tape. A secondary Sonal is 
displayed for the next library, and the user may choose the 
desired option. 


P ~ Position tape to a specified library Cand skip the current 
library). For this option, the user must supply the project 
name, library name, and type for a library on the tape. If 
the library is found a secondary panel is displayed, and the 
user may choose the desired option. If the end of tape is 
encountered before the library is found, the tape is rewound 
and the first retrieve panel is redisplayed. If the tape is 
positioned beyond the specified library, it is backspaced to 
that library. 


If the library read from tape has not been specified to SPF/CMS, 


the second panel shown in Figure 64 is displayed. The first 
option on this panel is: 


C - Create new SPF library. For this option, the library 
attributes must be specified on the lower part of the panel. 
This is the same information which may be specified under the 
file utility, option 3.2 ("specify"), except that the record 
format and length are are taken from the tape library. 


Other options on this panel are the same as those described above. 
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RETRIEVE TAPE FILE: SPFDEMO.MYLIB.PLI 
SELECT OPTION ===> _ 


M - MERGE WITH EXISTING LIBRARY NAMED: SPFDEMO.MYLIB.PLI 
I - IDENTIFY ALTERNATE LIBRARY NAME BELOW 

S ~- SKIP TO THE NEXT LIBRARY ON TAPE 

P - POSITION THE TAPE TO THE SPF LIBRARY NAMED BELOW 


SPF LIBRARY: (TAPE LIBRARY RECFM: F LRECL: 80 
PROJECT 
LIBRARY 
TYPE 


UPDATE PASSWORD ===> 


REPLACE LIKE-NAMED MEMBERS ===> NO CYES OR NO) 


RETRIEVE TAPE FILE: SPFDEMO.XXX.COBOL 
SELECT OPTION ===> _ 
C - CREATE NEW SPF LIBRARY NAMED: SPFDEMO.XXX.COBOL 
I - IDENTIFY ALTERNATE LIBRARY NAME BELOW 
S ~- SKIP TO THE NEXT LIBRARY ON TAPE 
P - POSITION THE TAPE TO THE SPF LIBRARY NAMED BELOW 


_ SPF LIBRARY: (EXISTING LIBRARY RECFM: F LRECL: 80 


PROJECT SPFDEMO 
LIBRARY 
TYPE 


UPDATE PASSHORD === 


SPECIFY LIBRARY ATTRIBUTES: 
ORGANIZATION Ss (S=SET OF FILES, M=MACLIB) 
OKNER'S ID KLEIN (BLANK FOR YOUR USERID) 
DEVICE ADDR. (BLANK FOR '191') 
LINK ACCESS MODE W (SPECIFY 'W', 'M', OR 'M’ FOR UPDATE ACCESS) 
CMS FILETYPE COBOL CIF ORG 'S‘ - BLANK FOR SPF ASSIGNED FILETYPE) 
CMS MACLIB NAME CIF ORG 'M' - BLANK FOR SPF ASSIGNED FILENAME) 


I 


vVvvVVVVv 





Figure 64. Retrieve Utility - Secondary Panels 


Utilities (Option 3) 123 


SCRIPT/VS UTILITY COPTION 3.9) 


When this option is selected, a sequence of panels is displayed to 
allow formatting, displaying, and printing of text maintained in 
SPF libraries or sequential CMS files. Use of this utility 
requires the installation of the Document Composition Facility 
CSCRIPT/VS), program product 5748-XX9, with the Foreground Envi- 
ronment Feature. 


This utility has the following options: 


1 - Draft document options 
2 - Final document options 


For the draft document options, it is assumed that the primary 
interest of the user is to assure that the content, syntax, and 
spelling within the document are correct. The final document 
options provide additional flexibility and control for the user 
interested in specific document formats. 


The first panel displayed by the SCRIPT/VS utility is used to 
select the draft or final options, and to specify the library or 
file to be formatted (Figure 65}. For SPF libraries, a member list 
will be displayed if a member name is not specified. A concat- 
enated sequence of SPF libraries may be specified to allow inclu- 
sion of imbedded or appended members from more than one library. 


Any SPF libraries to be processed by this utility must have an 
organization of "S" (set of sequential files). They need not have 
an SPF type qualifier of SCRIPT, and the corresponding set of 
files need not have a CMS filetype of SCRIPT. If, however, a CMS 
file id is specified (Con the second part of the panel) it must 
have a filetype of SCRIPT, and any imbedded or appended files must 
also have a filetype of SCRIPT unless they are explicitly defined 
via a SCRIPT ".dd" control word. 


SELECT OPTION ===> _ 


1 - DRAFT DOCUMENT OPTIONS 2 - FINAL DOCUMENT OPTIONS 


SPF LIBRARY TO BE FORMATTED: 
> SPFDEMO 
> MYLIB ===> DEPTLIB ===> ==> 
> SCRIPT 
> 


PROJECT === 
LIBRARY === 
TYPE === 
MEMBER === (BLANK FOR MEMBER SELECTION LIST) 
CMS. FILE TO BE FORMATTED: 

FILE ID ===> 

IF NOT LINKED SPECIFY: 

ONNER'S ID ===> DEVICE ADDR. ===> ACCESS MODE ===> 


OUTPUT LISTING FILE: (DEFAULT IS "MEMBER/FILENAME LISTING A') 
FILE ID ===> 


READ PASSNORD ===> 





Figure 65. SCRIPT/VS Utility - First Panel 
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Processing Sequence 


The processing sequence for the SCRIPT/VS utility is as follows: 


1. The user enters the appropriate information on the first 
panel, and presses the ENTER key. 


2. <A secondary panel is displayed for either the "draft" or 
"final™ document options, depending on which option was spec— 
ified on the first panel. The user enters the appropriate 
information on the secondary panel Csee below) and presses 
the ENTER key. 


3. The SCRIPT/VS formatter is invoked. If the "quiet" option has 
not been specified, the screen is blanked and a one-line mes~ 
sage is displayed, indicating that SCRIPT/VS processing has 
started. When processing is complete, a "MORE..." message is 
displayed in the lower right-hand corner of the screen. The 
user then presses PA2. 


4. The formatted output is displayed in browse mode. The output 
may be scrolled using the Scroll PF keys. All browse commands 
may be entered. When the user has finished browsing the out- 
put, he presses the End PF key. 


5. The SCRIPT/VS print panel is then displayed to allow the for- 
matted output to be printed, kept, or deleted. The user 
enters the appropriate information on this panel (see below) 
and presses the ENTER key. 


6. The specified action (print, keep, or delete) is taken and the 
first SCRIPT/VS panel is redisplayed. The user may then for- 
mat additional documents, or press the End PF key to return to 
the primary option menu. 


Note: If SCRIPT/VS terminates abnormally, an ABEND message is 
displayed in the upper right-hand corner of the screen. Browse is 
not entered. The listing file is retained, but the print option 
panel is not displayed. 


Draft Document Options 


When option 41 is selected on the first SCRIPT/VS panel, a second- 
ary panel is displayed to allow the user to specify the draft doc” 
ument options (Figure 66). All the parameters on this panel are 
optional. 


For automatic spelling verification, "yes" is entered in the 
spelling check field. Spelling verification must also be enabled 
within the document. (See the ".sv™ command in the SCRIPT/VS 
User's Guide. ) 


For all upper case printing, "yes" is entered in the upper case 
only field. 


For line numbers to be printed in the output document, "yes" is 
entered in the line number field. Line numbers can be useful for 
correcting errors and mis-spelled words, which SCRIPT/VS identi- 
fies by line number. 


Use of the “other SCRIPT parms" field allows input of any 
SCRIPT/VS parameters not on the panel. The NOPROF option must not 
be specified if the source is from an SPF library. 


If a SCRIPT/VS document profile is to be used, the user must enter 
the name of the CMS file that contains the profile in the "pro- 
file" field. A file id of PROFILE SCRIPT should be entered for 
the default profile. 
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To incorporate one or more user GML libraries, the user must enter 

’ the filename(s) in the "symbol/macro lib" field. These files must 
be MACLIBs. If no files are specified, the default GML library, 
if one is defined, is used. 


SCRIPT/VS DRAFT DOCUMENT OPTIONS 
FILE NAME: SPFDEMO.MYLIB.SCRIPT(DOCXYZ) 


SCRIPT/VS DRAFT OPTIONS: 
SPELLING CHECK ===> NO CYES OR NO) 
UPPER CASE ONLY ===> YES (YES OR NO) 
LINE NUMBER ===> YES (YES OR NO) 
OTHER SCRIPT PARMS 


PROFILE FILE ID 


SYMBOL/MACRO "LIB" FILE NAMES: 
/  SE=> GML 





Figure 66. SCRIPT/VS Draft Document Options 


Final Document Options 


When option 2 is selected on the first SCRIPT/VS panel, a second- 
ary panel is displayed to allow the user to specify the final doc” 
ument options (Figure 67). All the parameters on this panel are 
optional. However, if a device type is entered, the lines per 
inch and form definition fields must be correctly filled in. 


For automatic spelling verification, "yes" is entered in the 
spelling check field. Spelling verification must also be enabled 
within the document. (See the ".sv"™ command in the SCRIPT/VS 
User's Guide.) 


For all upper case printing, "yes" is entered in the upper case 
only field. 


The next four fields on the panel are used to describe the output 
device and the physical characteristics of the printed page. The 
type of printer on which the output will be printed Cand for which 
SCRIPT/VS will format the document) is specified in the "device 
type" field. If the document is to be printed on a device other 
than an IBM 1403 or 3800, this field should be left blank, and the 
aa hats should be specified in the "other SCRIPT parms"™ field (see 
elow). 


The "lines/inch", "form width" and "form length" fields are used 
to describe how the document should fit on the printed page. 
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The "3800 chars parm" field is used to specify the type font(s) if 
the document is being formatted for an IBM 3800 printer. The user 
may enter one or two SCRIPT/VS fonts or up to four 3800 character 
arrangement tables, separated by blanks. These same parameters 
must be specified on the SCRIPT/VS print panel (see below) with 
multiple CHARS parameters and an OPTCD=J parameter. 


The user may specify the page margin to be used in binding the 
document by entering the size of the margin in the "binding" 
fields. A different margin can be specified for even and odd num- 
bered pages. For more information, see "BIND" jin Document 


Composition Facility User's Guide, SH20-9161. 


Use of the "other SCRIPT parms" field allows input of any 
SCRIPT/VS parameters not on the panel. The NOPROF option must not 
be specified if the source is from an SPF library. 


If the "other SCRIPT parms" field is used to specify a device oth- 
er than the 1403 or 3800, the device must have been previously 
added to the SCRIPT/VS device characteristics table. A device may 
be selected from this table by leaving the "device type” field of 
the menu blank and specifying the SCRIPT/VS device parameter in 
the "other SCRIPT parms" field. 


If a SCRIPT/VS document profile is to be used, the user must enter 
the name of the CMS file that contains the profile in the "pro- 
file" field. <A file id of PROFILE SCRIPT should be entered for 
the default profile. 


To incorporate one or more user GML libraries, the user must enter 
the filename(s) in the "symbol/macro Llib" field. These files must 
be MACLIBs. If no files are specified, the default GML library, 
if one is defined, is used. 


SCRIPT/VS FINAL DOCUMENT OPTIONS 
FILE NAME: SPFDEMO.MYLIB.SCRIPT(DOCXYZ) 


SCRIPT/VS FINAL OPTIONS: 
SPELLING CHECK 
UPPER CASE ONLY 
DEVICE TYPE 
LINES/INCH 
PAGE WIDTH 
PAGE LENGTH 
3800 "CHARS" PARM 


uw wu me 
vVvvvVVYV Vv 


(YES OR NO) 

(YES OR NO) 

(1403 OR 3800) 

(6, 8 OR 12) 
(8.5, 11, OR 13.5) 
(6.5 OR 11) 


BINDING: OOD PAGE 
EVEN PAGE 


(SPECIFY MARGIN) 
(SPECIFY MARGIN) 


t tt 
Vv 


OTHER SCRIPT PARMS 
PROFILE FILE ID 


SYMBOL/MACRO "LIB" FILE NAMES: 
s==> GML 


Figure 67. SCRIPT/VS Final Document Options 
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SCRIPT/VS Print Options 


When the user has finished browsing the formatted document, 
pressing the End PF key will cause a panel to be displayed to 
allow the output to be printed, kept, or deleted (Figure 68). On 
this panel, the "file id" field shows the id of the output listing 
file that contains the formatted text. 


If option "P"™ (print file) is selected, the following spool param- 
eters may be speci fied: 


° Number of copies - if more than one copy is desired. 
° Spool class ~ for other than class A. 


° "For’ user ~ to spool the output to another user's virtual 
printer on the same VM system Cignored if either 
"user/machine id™ or "node/link id™ is specified). 


° 3800 keywords - if output is directed to an IBM 3800 printer 
which is attached to the CMS system as a virtual spooling 
device. See description of SPOOL command in VM/SP_ CP Command — 
Reference for General Users, $C19-6211. 


° User/machine id - to spool the output to the virtual reader of 
another user or machine. 


° Node/link id - if the desination is a remote node on the net- 
work (valid with either "user/machine id™ or "tag text", but 
not both). 


° Tag text - to specify control parameters for printing on a 
remote non-VM system. See description of TAG command in 


VM7370 RSCS Networking Program Reference. and Operations 
Manual, SH24-5005. 


SELECT OPTION ===> P 


P ~ PRINT FILE (AND DELETE) 
K - KEEP FILE - DO NOT PRINT 
D - DELETE (ERASE) FILE - DO NOT PRINT 
BLANK AND END KEY DELETES FILE WITHOUT PRINTING 


FILE ID: DOCXYZ LISTING Al 


SPOOL OPTIONS: 
NUMBER OF COPIES SPOOL CLASS ===> A *FOR' USER ===> 
3800 KEYNORDS CHARS TN_ 


FOR SPOOLING TO ANOTHER PERSON OR MACHINE: 
USER/MACHINE ID === 
NODE/LINK ID 
TAG TEXT 





Figure 68. SCRIPT/VS Print Panel 
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FOREGROUND COPTION 4) 


The foreground option provides an interface with standard lan- 
guage processors for foreground compilation and assembly of pro-~ 
grams stored in SPF libraries or CMS files. It also provides an 
interface to the FORTRAN and COBOL interactive debug facilities, 
and to the CMS LOAD command. 


The foreground selection menu is shown in Figure 69. 


FOREGROUND SELECTION MENU 


SELECT OPTION ===> 


— 


SYSTEM ASSEMBLER PL/I OPTIMIZING COMPILER 
OS/VS COBOL COMPILER oan 
- FORTRAN IV (G1) COMPILER COBOL INTERACTIVE DEBUG 
- PL/I CHECKOUT COMPILER FORTRAN INTERACTIVE DEBUG 
PASCAL/VS COMPILER 


Figure 69. Foreground Selection Menu 


When a language processor has been selected, an entry panel is 
displayed to allow the user to specify SPF library information or 
CMS filename, and processor options. Figure 70 shows an example 
for Assembler. The project name, first library name, type qual- 
ifier, and member name must be specified to assemble a program 
whose source is in an SPF library. The filename must be specified 
to assemble a CMS file with a filetype of ASSEMBLE. CIf the CMS 
filename is entered, it overrides any SPF library specification.) 
The other parameters are optional. 
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FOREGROUND ASSEMBLY | 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY 
PROJECT 
LIBRARY 

TYPE” 
MEMBER 


SPFDEMO 
=s=> TEST . s5=> MASTER 


CMS FILE: 
FILENAME ===> 
IF NOT LINKED, SPECIFY: _ 
ORNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSNORD ===> > UPDATE PASSWORD ===> 


ASSEMBLER OPTIONS: 
===> LIST NODECK OBJECT 


ADDITIONAL CONCATENATED MACLIBS: 
===> CMSLIB ===> OSMACRO ===> 





Figure 70. Foreground - Assembler Example 


Once the entry panel has been filled in and the ENTER key has been 
pressed, the screen is cleared and the appropriate language 
processor is invoked. The GLOBAL command and the command that 
invokes the language processor is displayed along with certain 
other output of the language processor (depending on the options 
chosen), such as error messages, prompts, and return codes. Any 
communication with the language processor is in line I/0 mode. 


Upon completion of the foreground processing, a "MORE..." message 
will be displayed in the lower right-hand corner of the screen. 
The user may then press the PA2 key to return to the processor 
entry panel. 


When the entry panel is redisplayed, a message indicating com- 
pletion of the process is displayed in the upper right-hand corner 
of the screen. The user may then enter other parameters and invoke 
the processor again or press the End PF key to return to the pre- 
vious menu. 


ASSEMBLER/COMPILER PROCESSING 


The Assembler entry panel shown in Figure 70 is typical of the 
‘language processor panels. In the figure, a library concat- 
enation sequence of three data sets has been specified. The con- 
catenation order is: 


SPFDEMO.XXX.ASM 
SPFDEMO.TEST.ASM 
SPFDEMO.MASTER.ASM 


Note: The SPF type qualifier for an assembler source library need 
not be ASSEMBLE, as illustrated in the example. 
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Before invoking the foreground processor, SPF scans the concat~- 


enated sequence of libraries to find the member to be assembled or 
compiled (member TOP in this example). A CMS file with a filetype 
acceptable to the language processor (ASSEMBLE in this example) 
is created on the user's A-disk by extracting the member from the 
first library in the sequence in which it occurs. 


For any library in the sequence that is a collection of sequential 
files, a MACLIB is created on the user's A-disk to enable the use 
of COPY or INCLUDE statements. (For performance reasons, it is 
recommended that high-level libraries be specified as MACLIBs.) 


Any temporary files created by SPF will be erased at the com- 
pletion of the foreground process. 


For this example, if SPFEDEMO.XXX. ASM is a colletion of sequential 
files and the higher-level libraries are already MACLIBs, the 
GLOBAL command preceding the ASSEMBLE command might look like: 


GLOBAL MACLIB SPF00511 TEST MASTER CMSLIB OSMACRO 


where SPF00511 is the SPF generated filename for the MACLIB con- 
taining all the members. of SPFDEMO.XXX.ASM. 


Note the following points: 


1. The concatenation sequence serves two purposes: It is used by 
SPF to locate the primary member to be assembled, and it 
allows inclusion of subsidiary members referenced by COPY 
statements in the assembler source. 


2. Other MACLIBs can be appended to the GLOBAL statement, fol- 
lowing the SPF libraries, by specifying them in the desired 
order in the “additional concatenated MACLIBs" fields. 


3. If the source is from an SPF library, the TEXT file is placed 
in an SPF library with a three-level name composed of the 
project name, the first library name, anda type qualifier of 
TEXT. The SPF member. name for the TEXT file is the same as 
the source member. The LISTING file is placed on the user's 
A-disk. Its filename is the same as the source member name. 


4. If the source is specified as a CMS file Crather than an SPF 
library), the filetype must be whatever is acceptable to the 
language processor CASSEMBLE itn this example). The resulting 
TEXT and LISTING files are placed on the user's A-disk. 


5. In specifying a CMS file that would require a LINK and ACCESS, 
the user must provide the necessary LINK information: The 
user id of the owner, the virtual device address of the mini- 
disk on which the source resides, and the desired link access 
mode (e.g, RR). 


6. The language processor options are passed to the processor 
exactly as specified by the user. Up to 16 tokens may be 
specified as processor options. Only those options specified 
on the panel are passed to the language processor; SPF does 
not automatically generate any options. 


The entry panels for the various compilers are similar to the one 
for Assembler. The meanings of the options differ among the 
several language processors. Check the user's guide for the spe- 
cific language aoe an explanation of the processor options. 


Compiler output is S nandled aiFfarentiv in the following cases: 


° When the TEST option is specified for the FORTRAN ebipi lets a 
special TEXT file is produced for later use by the FORTRAN 
interactive debug facility. The file is not placed in an SPF 
library. Rather, it is left on the user's A-disk, as is the 
generated FORTRAN file. ; 


° When the TEST option is specified for the COBOL compiler, a 


SYSUT5 file is produced for later use by the COBOL interactive 
debug facility. The file is placed on the user's A-disk. 
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° oa the OBJECT option is specified for the PL/I Checkout com~ 

iler, a special TEXT file Ca "Link edit stub™) and an ITXTLIB 

file Cinterpretable text) are produced for later use with the 
PLICR command. Both files are placed on the user's A-disk. 


The entry panels for the interactive debug facilities differ 
somewhat from the other foreground panels: 


° The COBOL interactive debug panel allows specification of up 
to four additional program ids (which must match the external 
filenames), and PRINT and SOURCE options which determine what 
FILEDEFs are generated by SPF. Also allowed are 15 tokens of 
execution parameters that are stacked for use by the process~ 
or, and the specification of up to four additional TXTLIBs. 


° The FORTRAN interactive debug panel allows variations of the 
DISK or PRINT options, the specification of up to four addi- 
tional filenames, and the specification of up to four TXTLIBs 
to be included in the GLOBAL TXTLIB command. 


LOAD PROCESSING 


This foreground option Coption 4.6) provides an interface to the 
LOAD command (Figure 71). The entry panel allows a simple LOAD 
and GENMOD command to be issued with the specified options, or a 
user-specified EXEC to be issued for more complex: load functions 
with multiple filenames, INCLUDES, etc. 


ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


CNS FILE: 
FILENAME ===> 
IF NOT LINKED, SPECIFY: 
OKNER'S ID ===> DEVICE ADDR. === LINK ACCESS MODE ===> 


READ PASSWORD ===> 


USER EXEC ===> (USER’S EXEC TO BE RUN INSTEAD OF LOAD/GENMOD ) 
OPTIONS: , 


LOAD 


===> CLEAR MAP 
GENMOD === 


> MAP 


ADDITIONAL CONCATENATED TXTLIBS: 


=s=2> ===> 





Figure 71. Foreground ~ LOAD Panel 
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BATCH COPTION 5) 


The batch option provides an interface with standard language 
processors for compilation and assembly in the CMS batch machine 
of programs stored in SPF libraries or CMS files. It also pro- 
vides an interface for batch execution of the CMS LOAD command. 


The batch selection menu is shown in Figure 72. It allows the 
user to enter job statement parameters as well as select a lan- 
guage processor. 


As with other secondary menus, it is possible to bypass the batch 
selection menu by entering two numbers, separated by a decimal 
point, on the primary option menu. For example, "5.2" to select a 
batch COBOL compile. Note, however, that use of this procedure 
does not allow verification or changes to the job statement param- 
eters, nor does it allow the generation of multiple compilations 
(multiple job steps) within the same job. 


SELECT OPTION ===> _ 
1 - SYSTEM ASSEMBLER PL/I CHECKOUT COMPILER 
2 - OS/VS COBOL COMPILER PL/I OPTIMIZING COMPILER 
3 - FORTRAN IV (G1) COMPILER LOAD 
PASCAL/VS COMPILER 


BATCH JOB INFORMATION: (ENTER OR VERIFY BEFORE PROCEEDING) 
(YOUR CMS USER ID AUTOMATICALLY BECOMES YOUR BATCH JOB USER ID.) 


BATCH MACHINE ID ===> CMSB 


JOB STATEMENT INFORMATION: 
ACCOUNT NUMBER ===> U101 > 
JO3 NAME ==s=> LEM 


Figure 72. Batch Selection Menu 


When job information has been entered and a language processor 
selected, an entry panel is displayed to allow the user to specify 
SPF library information or CMS filename, and processor options. 
Figure 73 shows an example for the PL/I optimizing compiler. The 
project name, first library name, type qualifier, and member name 
must be specified to compile a program whose source is in an SPF 
library. The filename must be specified to compile a CMS file 
with a filetype of PLI or PLIOPT. CIf the CMS filename is entered, 
it overrides any SPF library specification.) The other parame~ 
ters are optional. 
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BATCH PLI OPTIMIZING COMPILE 
ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


oe 


> SPFDEMO 

> LARRY ===> V3TEST ===> MASTER 

> PLI Pree 
> TOPSEG_ 


CMS FILE: 
FILENAME ===> 
IF NOT LINKED IN YOUR ‘LOGON DIRECTORY, SPECIFY: 
OWNER'S ID ===> ° DEVICE ADDR. ===> . LINK ACCESS MODE ===> 


READ PASSWORD ===> UPDATE PASSHORD | s=S> 


COMPILER OPTIONS: 
===> MACRO OBJECT SOURCE XREF : 


ADDITIONAL CONCATENATED MACLIBS: 


===> ‘ ===> 





Figure 73. Batch - PL/I Optimizing Compiler Example 


When the user has filled in the:panel and pressed the ENTER key, 
SPF generates the appropriate commands to be run in the batch 
machine. After SPF has generated the commands, it returns to the 
batch selection menu Cunless that menu was bypassed by entering 
two numbers on the primary menu), with a message "job step gener- 
ated" displayed in the short message area (line 1). If the batch 
selection menu was bypassed, SPF submits the generated commands 
and returns to the primary option menu. In either case, the user 
may exit from the processor entry panel without generating any 
commands by pressing the End PF key rather than the ENTER key. 


When the batch selection menu is redisplayed, the job statement 
parameters are shown for information only -~- they are no longer 
intensified and may not be overtyped. At this point, the user may 
select another processor to cause more commands Canother job 
step) to be generated, enter CANCEL to return to the primary 
option menu without submitting the job, or press the End PF key 
Cor Return PF key) to cause the generated Commences to be submitted 
to the batch machine for execution. 


If the job is submitted, a confirmation message is displayed, 
accompanied by a "HOLDING™ message in the lower right-hand corner 
of the screen. When the user presses the PA2 key, SPF returns to 
the the primary option menu. 


The batch machine. sends messages to the user indicating the 
progress of the job. When the job has completed, the SPF reader 
utiltiv Coption 3.7) may be used to retriave aca and LISTING 
files produced by the batch job. 


Caution: Erroneous results may occur if the batch option is used 
in split screen mode while punch output is also being generated 
from the other logical screen. Output from. the two logical 
screens may be intermingled on the virtual punch Ay the user jumps 
back and forth between the screens. 
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ASSEMBLER/COMPILER PROCESSING 


The entry panel shown in Figure 73 is typical of the batch 
language processor panels. In the figure, a library concat- 
enation sequence of three libraries has been specified. The con- 
catenation order is: 


SPFDEMO.LARRY.PLI 
SPFDEMO.V3TEST.PLI 
SPFDEMO.MASTER.PLI 


Before invoking the batch process, SPF will scan the concatenated 
sequence of libraries to find the member to be assembled or com- 
piled (member TOPSEG in this example). A CMS file with a filetype 
acceptable to the language processor (PLI in this example) will be 
created on the user's A-disk by extracting the member from the 
first library in the sequence in which it occurs. 


For any library in the sequence that is a collection of sequential 
files, a MACLIB will be created on the batch machine's A-disk to 
enable the use of COPY or INCLUDE statements. (For performance 
reasons, it is recommended that high-level libraries be specified 
as MACLIBs.) : 


Any temporary files created by SPF will be erased at the com- 
pletion of the batch process. 


Note the following points: 


1. The concatenation sequence serves two purposes: It is used by 
SPF to locate the primary member to be compiled, and it allows 
inclusion of subsidiary members referenced by INCLUDE state- 
ments in the PL/I source. 


2. Other MACLIBs can be appended to the GLOBAL statement, fol- 
lowing the SPF libraries, by specifying them in the desired 
order in the “additional concatenated MACLIBs"”" fields. 


3. The read password speci fied on the data entry panel must pro- 
vide access to the user's A-disk.as well as the source data. 
A minidisk with a.-read password of ALL will be accessible 
regardless. of the password specified on the panel. 


4. The TEXT and LISTING #7 hes produced by the batch process are 
placed in the user's virtual-néader using the DISK DUMP com- 
mand. The SPF reader utility=:Coption 3.7) may be used to 
retrieve these files following: completion of the job. 


5. If the source is specified as a CMS file (rather than an SPF 
; library), the filetype must be whatever is acceptable to the 
language processor (PLI or PLIOPT in this example). 


6. In specifying a CMS file that would require a LINK and ACCESS 
(i.e., if the file is on a minidisk not defined by an MDISK or 
LINK statement in the user's own LOGON directory), the user 
must provide the necessary LINK information: The user's id 
whose directory does contain that information, the virtual 
device address of the minidisk on which the source resides, 
and the desired link access mode (e.g, RR). 


7. The language processor options are passed to the processor 
exactly as specified by the user. Up to 15 tokens may be 
specified as processor options. Only those options specified 
on the panel are passed to the language processor; SPF does 
not automatically. generate any’: soptions. 


The entry panels for. Assembler and: other compilers are similar to 
the one for the PL/I Optimizer. The meanings of the options dif- 
fer among the several language processors. Check the user's guide 
hae the specific Zenaione for an. explanation of the processor 
options. 
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Compiler output is handled differently in the following cases: 


° When the TEST option is specified for the FORTRAN compiler, a 

special TEXT file is produced for later use by the FORTRAN 
interactive debug facility. The file is punched to the user's 
Virtual reader, as is the generated FORTRAN file. 


o ‘When the TEST option is specified for the COBOL compiler, a 
SYSUT5 file is produced for later use by the COBOL interactive 
debug facility. The file is punched to the user's virtual 
reader. , 


° When the OBJECT option is specified for the PL/I Checkout com- 
piler, a special TEXT file (a "link edit stub") and an ITXTLIB 
file Cinterpretable text) are produced for later use with the 
PLICR command. Both files are punched to the user's virtual 
reader. 


LOAD PROCESSING 
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This batch option Coption 5.6) provides an interface to the LOAD 
command (€Figure 74). The entry panel allows a simple LOAD and 
GENMOD command to be issued with the specified options, or a 
user-specified EXEC to be issued for more complex load functions 
with multiple filenames, INCLUDES, etc. 


ENTER/VERIFY PARAMETERS BELOW: 


SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 
MEMBER 


CMS FILE: 
FILENAME ===> 
IF NOT LINKED IN YOUR LOGON DIRECTORY, SPECIFY: 
ORXNER'S ID ===> . - DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSHORD ===> 


USER EXEC ===> (USER'S EXEC TO BE RUN INSTEAD OF LOAD/GENMOD ) 
OPTIONS: 
LOAD 


= CLEAR MAP 
GENNOD = 


=> 
=> MAP 


ADDITIONAL CONCATENATED. TXTLIBS: 


s==> s=='>. 





Figure 74. Batch - LOAD Panel 
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COMMAND COPTION 6) 


The command option allows direct entry of a CMS command, CP com- 
mand, EXEC, or entry to CMS subset under SPF. When this option is 
selected, the CMS command panel is displayed (Figure 75). 


ENTER COMMAND BELOW: 


===> < 





ANY ONE OF THE FOLLOWING MAY BE ENTERED: 


~ A CMS COMMAND 

- A CP COMMAND 

~ AN EXEC SPECIFICATION 

- CMS (TO ENTER CNS SUBSET MODE, USE RETURN COMMAND TO 
RETURN FROM SUBSET TO SPF) 





Figure 75. CMS Command Panel 


The command or EXEC is entered to the right of the arrow, using 
standard CMS syntax. It may be continued on the next line, if 
necessary. Entering "CMS™ causes entry to the CMS subset. In sub- 
set mode, more than one command may be entered at a time, and the 
PF and PA keys revert to their CMS definitions. The RETURN com- 
mand is used to exit subset mode. 


When the ENTER key is pressed, the command and any resulting out- 
put are displayed on the screen as in a normal CMS environment. 
(The return code presentation may appear slightly different.) 
Following the last Line displayed by the command, a "MORE..." mes- 
sage is displayed in the lower right-hand corner of the screen. 
The user should then press PA2. 


When the PA2 key is pressed, the panel is redisplayed. The command 
which was just executed is pre-entered to the right of the arrow. 
The user may then enter another command, or press the End PF key 
to return to the primary option menu. 
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Option 6 cannot be used to: 


° Enter SPF recursively 


° Leg off 


° Issue ccnmeade of a privileged class beyond the user! s class 
° Issue immediate commands CHX,; HB, HO, etc.) 


° peecey ee that require the VM Communication Facility 


Results in all these cases are unpredictable. 


Caution: When a CMS command or EXEC is executing under option 6, 


do not attempt to enter an HX Chalt execution) command. This will 
halt all commands or programs, including SPF, bypassing the 
normal SPF termination procedure. If this is done, a re-IPL of 
CMS will be required. | 


SPF-VM Program Reference 





SUPPORT COPTION 7) 


The support option provides test aids and conversion utilities 
for the development of applications to be run under the SPF dialog 
manager. The dialog manager is described in a separate document, 


SPE Dialog Management Services. 


The support selection menu is shown in Figure 76. 


SUPPORT SELECTION MENU ---~-----~ ee 


SELECT OPTION ===> 


TEST PANEL DISPLAY PANEL AS USER WOULD SEE IT 

TEST FUNCTION INVOKE DIALOG FUNCTION OR SELECTION MENU 

TEST VARIABLES - SET OR DISPLAY VARIABLES FCR TEST FUNCTION 
CONVERT MENUS CONVERT SELECTION/TUTORIAL MENUS TO NEW FORMAT 
CONVERT MSGS CONVERT MESSAGES TO NEW FORMAT 

TEST MENU TEST OLD FORMAT SPF MENUS 


Figure 76. Support Selection Menu 


A new shared variable pool, referred to as the "test pool," is 
established when option 7 is invoked. Any variables that are set 
or displayed by options 7.1 or 7.3 are from this pool. Functions 
that are invoked under option 7.2 may copy variables from and to 
the test pool by means of VGET and VPUT services. 


The test pool simply takes the place of the normal shared variable 
pool to isolate variables in the option 7 environment from vari- 
ables being used in the normal environment. 


Installations that have previously extended or custom tailored 
SPF may need to convert old format selection menus to the new pan- 
el formats. A conversion utility to assist in this process is 
provided by options 7.4. 


The following sections describe each of the support functions, 
corresponding to the six options on the support selection menu. 
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TEST PANEL COPTION 7.1) 
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When this option is selected, a panel is displayed that allows 
entry of the name of a panel to be tested. A message id and ini- 
tial cursor location may also be specified (Figure 77). These are 
the same parameters that may be specified (from a dialog function) 
when invoking the DISPLAY service. 


The specified panel is fetched from the panel library and dis~ 
played as the end user would see it. Any variables referenced in 
the panel definition are accessed from the test pool. 


Information may be entered on the panel being tested. It is 
stored in the corresponding variables in the test pool. 


When the End PF key is pressed from the panel being tested, the 
option 7.1 panel is redisplayed. oe 


THIS FUNCTION IS USED TO TEST SPF PANEL DEFINITIONS. THE 
PANEL WILL BE DISPLAYED AS THE END USER WOULD SEE IT. YOU MAY 
OPTIONALLY ENTER A MESSAGE ID TO BE DISPLAYED ON THE PANEL 
AND/OR THE NAME OF THE FIELD WHERE THE CURSOR IS TO BE PLACED. 


ENTER THE FOLLOWING: 
PANEL NAME ===> 
MESSAGE ID =o=> (OPTIONAL) 
SURSOR FIELD ===> (OPTIONAL) 


ENTER THE NAME OF THE PANEL TO BE TESTED OR PRESS END KEY TO EXIT 


Figure 77. Entry Panel for Testing a Panel Definition 
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TEST FUNCTION COPTION 7.2) 


The test function option allows a dialog function or menu hierar- 
chy to be tested without having to build "scaffolding" code. 


When this option is selected, a panel is displayed that allows 
entry of a command or program name (to invoke a function), or a 
panel name to test a menu hierarchy (Figure 78). The information 
that may be entered on this panel corresponds to the parameters 
that may be specified (from a dialog function) when invoking the 
SELECT service. 


When the invoked function completes execution, or the End PF key 
is pressed from the specified panel (selection menu), the test 
function entry panel is redisplayed. 


je ne eee ee ee gee eee 


INVOKE FUNCTION OR SELECTION MENU 


THIS PANEL IS USED TO INVOKE A DIALOG FUNCTION (COMMAND OR 
PROGRAM) OR A SELECTION MENU (PANEL). THE PARAMETERS WHICH 
MAY BE ENTERED ARE THE SAME AS FOR THE SELECT SERVICE. 

THE "OPT" AND '"PARM" PARAMETERS ARE OPTIONAL. 


TO INVOKE A SELECTION MENU: 
PANEL ===> OPT 


TO INVOKE A COMMAND: 
CMD s==> 


TO INVOKE A PROGRAM: 
===> 


PGM -PARM 


FOR ANY OF THE ABOVE: 
NEWAPPL ===> CYES OR NO) 





Figure 78. Entry Panel for Testing a Function 
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TEST VARIABLES (OPTION 7.3) 


The test variables option allows dialog variables to be set and/or 
displayed in the test pool. It is intended for use with the test 
panel and test function options. 


When this option is selected, a panel is displayed that allows 

entry of variable names down the left-hand column. This column 

has underscores as pad characters to indicate where the names may 

de nies (the underscores need not be blanked out). See 
igure = aS | 


The current contents of a variable in the test pool may be dis- 

played simply by entering the name of the variable and pressing 

bale oa key. The value will then be displayed to the right of 
e colon. a 


The contents of a variable in the test pool may be set by entering 
the variable name, changing the colon to an equal sign (=), enter- 
ing the desired value to the right of the equal sign, and then 
pressing the ENTER key. 


‘More than one variable may be displayed or set in the same inter- 
action. 


SET OR DISPLAY TEST VARIABLES 


TO DISPLAY A VARIABLE, ENTER NAME. EXAMPLE: “ABC : 
‘TO SET A VARIABLE, CHANGE COLON 

TO EQUAL SIGN AND ENTER VALUE. EXAMPLE: ABC. = XYZ 
THE UNDERSCORES ARE PAD. CHARACTERS; THEY NEED NOT BE BLANKED OUT. 


“NAME VALUE 
ASMOPT__ : LIST, TEST, TERM,RENT 
COUNT: 29 _—— . 
PROJECT_ : SPFDEMO 
LIB1 NYLIB 


ee. ¢ of 8e be 


. 
PS 
a 
e 
e 
. 
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Figure 79. Entry Panel for Testing a Variable 
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CONVERT MENUS COPTION 7.4) 


Installations that have previously extended or custom tailored 
SPF must ensure that the primary option menu and all lower 
selection menus that were displayed by the SPFUTIL program are in 
new format. In new SPF, these menus are displayed by the SELECT 
service. The SPFUTIL program no longer exists. 


The convert menus option provides automated conversion of some 
old format menus to new format panel definitions. Two panels are 
displayed that are similar to the move/copy utility Coption 3.3). 
Old format members are read from the first ("from") library, con- 
verted to the new panel format, and stored in the second ("to") 
library. The "from" and "to" panels are shown in Figure 80. Note 


that unlike the move/copy utility, there is no option selection -- . 


it is always a copy operation. 


If a menu cannot be converted, a special panel is stored in the 
second library. It is a displayable "box" panel with a message 
indicating the name of the correspondina old menu that could not 
be converted. 


The convert menus option will handle only two types of old format 
menus: 


° Lower level selection menus (below the primary option level). 
This ts limited to selection menus that were designed speci f~ 
ically to be processed by the SPFUTIL program in the previous 
SPF products. 


° Tutorial pages. 


Do not attempt to convert a primary option menu via this utility. 
If you have added options to the old primary option menu, you must 
manually add these options to the new primary option menu. 


Also, no attempt should be made to convert foreground and batch 
menus, except for the foreground selection menu Cold name FORA, 
new name ISPFORA). The foreground selection menu must be con- 
verted to new format, and may be converted with this utility. All 
other foreground and batch displays, including the batch 
selection menu are supported in old format only. See SPFE-VM 
Installation and Customization for more information. 


Conversion of tutorial pages is optional; both formats are sup- 
ported. If you develop additional tutorial pages, use of the new 
format is recommended since it is simpler than the old. 


This utility cannot handle the bypassing of a tutorial page that 
is viewed only if explicitly selected (bypassed in the normal flow 
when the user keeps pressing the ENTER key). The converted page 
will not be bypassed in the normal flow. To correct the problem, 
manually change the parent panel by inserting an asterisk in front 
of the panel name in the TRANS) statement. See SPF _Dialo 

Management Services for more information. 
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CONVERT MENUS 
SPECIFY “OLD FORMAT" LIBRARY BELOW: 


FROM SPF LIBRARY: 
PROJECT 
LIBRARY 
TYPE 


MEMBER (BLANK FOR MEMBER LIST, * FOR ALL MEMBERS) 


FROM CMS FILE: 
FILE ID ===> 
MEMBER | ===> (FOR MACLIB OR TXTLIB) 
IF NOT LINKED, SPECIFY: 
OWNER'S ID DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD UPDATE PASSWORD ===> 


PRESS ENTER TO SPECIFY "NEW FORMAT" LIBRARY 


COPY --- OLD FORMAT SPF22.0URMODS.MENUS 
SPECIFY "NEW FORMAT" LIBRARY BELOW 


TO SPF LIBRARY: 
PROJECT ===> ISP 
LIBRARY ===> OURMODS 
==> ISPPLIB 
==> 


CMS FILE: 

FILE ID ===> 

MENBER ===> 

IF NOT LINKED, SPECIFY: 

OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


UPDATE PASSHORD ===> 


REPLACE LIKE-NAMED MEMBERS ===> (YES OR NO) 





Figure 80. Entry Panels for Converting Menu Definitions 
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CONVERT MESSAGES COPTION 7.5) 


The convert messages option provides automated conversion from 
old format SPF message definitions to new format message defi- 
nitions. As with option 7.4%, two panels are displayed that are 
similar to the move/copy utility. Old: format members are read 
from the first library, converted to new message format, and 
stored in the second library. 


Variable fields in old format messages are converted to dummy var- 
jable names, beginning with an ampersand. These must be changed 
manually to the appropriate dialog variable names. 


Generally, installations that have previously extended or custom 
tailored SPF should not need to convert message formats. This 
utility is intended to assist in development of new dialogs that 
use messages derived from existing Cold format) messages. 


The restriction on message formats is that only new format mes~- 
sages may be displayed on new format panels, and old format mes~- 
sages on old format panels. The new LOG service will write only 
new format messages to the SPF log file. Log messages specified 
via foreground and batch procs must remain in old format. 


TEST MENU COPTION 7.6) 


The test menu option allows old format SPF menus to be displayed 
as the end user would see them. Old format menus are still used 
for the foreground and batch options in the SPF program develop~ 
ment facility. 


When this option is selected, a panel is displayed that allows 
entry of an old format menu name. See Figure 81. When the speci- 
fied menu is displayed, the initial values for the input and vari-~ 
able output fields are displayed as "VAL OL", "VAL 02", etc. The 
numbers correspond to the numbers on the action statements in the 
a definition. The menu tester supports up to 50 action state- 
ments. 


When the menu is displayed, information may be entered into the 
input fields. The input and variable output fields may be ini- 
tialized prior to displaying the menu by first displaying a menu 
named SETUP. The procedure is as follows: 


1. Enter SETUP as the menu name on the test menu display. 

2. On the SETUP menu, fill in the desired parameters by overtyp- 
ing "VAL 01", "VAL 02", etc. These values will be passed as 
initial values to the menu to be tested. 


3. Press ENTER or the End PF key to return to the test menu dis- 
play. 


4. Enter the name of the menu to be tested on the test menu dis- 
play. 
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pene NAME = 


THIS FUNCTION IS USED To TEST OLD FORMAT SPF MENUS. DO NOT TRY TO USE THIS 
FUNCTION TO TEST NEW FORMAT SPF PANELS. 


SEVEN SPECIAL CHARACTERS ARE USED ON MENU DEFINITION STATEMENTS TO DEFINE EACH 
OF 7 MENU FIELD TYPES. THE SPECIAL CHARACTERS ARE REPLACED BY THE APPROPRIATE 
HARDWARE ATTRIBUTE BYTES, AND APPEAR ON THE SCREEN AS BLANKS. THE SPECIAL 
CHARACTERS (LISTED IN ORDER OF USE BY THE “<FIELDS>" MENU STATEMENT) ARE: 


4 


INPUT (UNPROTECTED), NON-DISPLAY. 

INPUT (UNPROTECTED), INTENSIFIED DISPLAY. 

INPUT (UNPROTECTED), NORMAL DISPLAY. 

OUTPUT (PROTECTED), INTENSIFIED DISPLAY. 

OUTPUT (PROTECTED), NORMAL DISPLAY. 

~ VARIABLE OUTPUT (PROTECTED), INTENSIFIED DISPLAY. 
- VARIABLE OUTPUT (PROTECTED), NORMAL DISPLAY. 


I net RO mm N 


FOR FURTHER INFORMATION ON MENUS REFER TO THE SPF INSTALLATION GUIDE. 


ENTER THE NAME OF THE MENU TO BE TESTED OR PRESS PF3 (END KEY) TO EXIT. 


Figure 8l. Panel for Testing Old Format Menus 
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TUTORIAL COPTION T) 


The tutorial option provides immediate online reference and 
instruction on how to use the SPF program development facility. 
It may be invoked from the primary. option menu or via the Help PF 
key. The tutorial may be viewed sequentially from beginning to 
end, or it may be viewed randomly by selecting specific topics 
from an alphabetic index or table of contents. 


When the tutorial is invoked. from the primary option menu, intro-~ 
ductory pages are displayed to explain how the tutorial works 
(Figure 82). Following the introduction, a table of contents is 
displayed from which the user may select a topic by entering the 
desired section number. 


When the tutorial is invoked via the Help PF key, the appropriate 
section of the tutorial is entered based on what the user was 
doing when the Help key was pressed. 


When viewing the tutorial, the user may select topics by number, 
or simply press the ENTER key to view the next topic. On any pan- 
el, the user may also enter the following commands: 


BACK or B - to back up to the previously viewed page 


SKIP or S - to skip to the next topic 

UP or U - to display a higher level list of topics 
TOP or T - to display the table of contents 
INDEX or I - to display the tutorial index 


During execution of the tutorial, the four scroll PF keys are 
interpreted as follows: 


UP - display higher level list of topics 
DOWN (skip) - skip to the next topic 

LEFT Cback) - display previous tutorial page 
RIGHT (next) - display next tutorial page 


The ENTER key also means "next." 


The Help PF key may be pressed at any time to display a one-page 
summary of how to use the tutorial. 


The tutorial function is terminated by pressing the End PF key. 


This causes a return either to the primary option menu or to the 
display from which the user requested help. 
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SPF TUTORIAL 


SPF PROGRAM DEVELOPMENT FACILITY 


TUTORIAL 


THIS TUTORIAL PROVIDES ON-LINE INFORMATION ABOUT THE FEATURES AND OPERATION 
OF SPF. YOU MAY VIEW THE TUTORIAL SEQUENTIALLY, OR YOU MAY CHOOSE SELECTED 
TOPICS FROM LISTS THAT ARE DISPLAYED ON MANY OF THE TUTORIAL PAGES. 


THE TABLE OF CONTENTS CONTAINS A LIST OF MAJOR TOPICS. SUBSEQUENT PAGES 
CONTAIN ADDITIONAL LISTS THAT LEAD YOU TO MORE SPECIFIC LEVELS OF DETAIL. 
TOPICS MAY ALSO BE SELECTED FROM THE TUTORIAL INDEX. 


THE NEXT TWO PAGES CONTAIN A DESCRIPTION OF HOW TO USE THIS TUTORIAL. 
PRESS ENTER TO PROCEED TO THE NEXT PAGE, OR 


PRESS UP KEY TO GO DIRECTLY TO THE TABLE OF CONTENTS>» OR 
PRESS END KEY TO RETURN TO THE PRIMARY OPTION MENU. 





TUTORIAL ----~-~----~---------- INTRODUCTION ----~-~--~--------~-------- TUTORIAL 
NEXT SELECTION ===> _ 


YOU MAY VIEW THE TUTORIAL SEQUENTIALLY BY SIMPLY LEAVING THE "NEXT SELECTION" 
FIELD BLANK AND PRESSING THE ENTER KEY. ALTERNATIVELY, YOU MAY SELECT TOPICS 
FROM LISTS THAT ARE DISPLAYED ON MANY OF THE TUTORIAL PAGES. FOR EXAMPLE, 
ENTER: NEXT SELECTION ===> 3 TO SELECT TOPIC 3. 


YOU MAY ALSO ENTER ONE OF THE FOLLOWING CODES IN THE "NEXT SELECTION" FIELD 
ON ANY TUTORIAL PAGE: 
BACK OR B - TO BACK UP TO THE PREVIOUSLY VIENED PAGE. 
SKIP OR S - TO SKIP THE CURRENT TOPIC AND GO ON TO THE NEXT TOPIC. 
UP OR U - TO DISPLAY A HIGHER LEVEL LIST OF TOPICS. 
TOP) OR T - TO DISPLAY THE TABLE OF CONTENTS. 
INDEX OR I - TO DISPLAY THE TUTORIAL INDEX. 


(CONTINUED ON NEXT PAGE) 


Figure 82. Tutorial - First Two Pages 
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APPENDIX A. SAMPLE PROBLEM 


This sample problem is a brief scenario of SPF terminal operations 
(Figure 83 through Figure 85). It is intended to serve as a dem- 
onstration that SPF has been properly installed and is opera- 
tional. It may also be useful for new users aS a quick 
introduction to SPF. 


The scenario requires the installation of file ISPSAMP ASSEMBLE 
Cincluded on the SPF basic distribution tape), which should be 
available for read-only access on the SPF system mini~disk. 


Prior to starting this sample problem, you should make sure that 
there are no files in your virtual reader. 
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ACTION ' ° RESULT 





, 1 e 


LOGON AND IPL CNS (IF REQUIRED) 
TYPE "ISPF" . 

SELECT UTILITIES (OPTION 3) 
SELECT FILE UTILITY (OPTION 2) 


SELECT "SPECIFY" (S) AND ENTER: 
PROJECT : SAMPLE 

LIBRARY : USERID (YOUR VM USERID) 
TYPE ASM 


ENTER THE FOLLOWING: 
ORGANIZATION s 
RECORD FORMAT F 
RECORD LENGTH 80 

LINK ACCESS MODE : W . 
(LEAVE OTHER FIELOS BLANK) 


@ 08 00 06 


SELECT "SPECIFY" AGAIN AND ENTER: 
PROJECT : SAMPLE (SAME AS BEFORE) 
LIBRARY : USERID (SAME AS BEFORE) 
TYPE 3: TEXT 


(SAME ORGANIZATION, RECORD FORMAT; 
RECORD LENGTH, AND MODE LETTER 
SHOULD BE PRE-ENTERED}). 

PRESS ENTER KEY. 

PRESS PF3 (END KEY) 

PRESS PF3 

SELECT MOVE/COPY (OPTION 3.3) 


SELECT COPY (C) AND ENTER: 
CMS FILE ID ; ISPSAMP ASSEMBLE 


BLANK OUT CMS FILE ID AND ENTER: 
PROJECT : SAMPLE 

LIBRARY : USERID (YOUR VM USERID) 
TYPE ASM 
MEMBER ASMTEST 


PRESS PF3 


SELECT BROWSE (OPTION 1) 


BLANK OUT CMS FILE ID AND ENTER: 


PROJECT 
LIBRARY 
TYPE 
MEMBER 


SAMPLE 
USERID 
ASM 


ce @f 0 06 


(LEAVE BLANK) 


SELECT MEMBER ASMTEST 


- CENTER S AHEAD OF MEMBER NAME ) 


SCROLL FORWARD ONE PAGE (PFS) 


SCROLL BACKWARD ONE PAGE (PF7) 


ENTER COMMAND INPUT : 
===> FIND COMMENT 


FIND NEXT OCCURRENCE OF "COMMENT" ~ 


BY PRESSING PF5 


1. READY MESSAGE 
SPF PRIMARY OPTION MENU 
UTILITY SELECTION MENU 
“FILE UTILITY PANEL 


SPECIFY NEW LIBRARY PANEL 


*SAMPLE.USERID.ASM' IS 
' SPECIFIED AS AN SPF 
LIBRARY. FILE UTILITY 
“PANEL IS REDISPLAYED. 


SPECIFY NEW LIBRARY PANEL 


"SAMPLE .USERID.TEXT' IS 
SPECIFIED AS AN SPF 
LIBRARY. FILE UTILITY 
PANEL IS REDISPLAYED. 


9. UTILITY SELECTION MENU 
10. SPF PRIMARY OPTION MENU 
Il. MOVE/COPY UTILITY PANEL 
12. SECOND MOVE/COPY PANEL 
13. ISPSAMP ASSEMBLE FILE IS 
COPIED TO YOUR LIBRARY 
(SAMPLE .USERID.ASM) AS 
MEMBER ASMTEST. 
THE FIRST MOVE/COPY PANEL 
IS REDISPLAYED. 
SPF PRIMARY OPTION MENU 
BROWSE ENTRY PANEL 
BROWSE MEMBER SELECTION 
LIST OF SPF LIBRARY 
"SAMPLE .USERID.ASM'. 
ONLY ONE MEMBER (ASMTEST) 
IN LIST. 


BROWSE DATA DISPLAY OF 
SANPLE .USERID .ASM( ASMTEST ) 


SECOND PAGE OF ASMTEST 
, FIRST PAGE OF ASMTEST AGAIN 


STRING "COMMENT" IS 
INTENSIFIED. 


SECOND OCCURRENCE OF 
“COMMENT IS INTENSIFIED. 


Figure 83. Sample Problem Scenario (Part 1 of 3) 
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ACTION RESULT 


MEMBER SELECTION LIST 


FRESS PF3 22. 


PRESS PF3 23. 


PRESS PF3 24. 


SELECT EDIT (OPTION 2) 25. 
ENTER SPF 
PROJECT : 
LIBRARY : 
TYPE 3 
MEMBER; 


LIBRARY: 
SAMPLE 
USERID 
ASM 
ASNTEST 


FIND THE LINE CONTAINING THE 
STRING "COMMENT" BY USING THE 
COMMAND ===> FIND COMMENT 


28. DELETE THE COMMENT BY PRESSING 28. 

ERASE EOF 
29. REPEAT THE NEXT COMMENT LINE BY 29. 

OVERTYPING THE FIRST DIGIT OF 

THE LINE NUMBER WITH "R". 
30. ENTER THE COMMAND ===> PRINT ON 30. 
31. TRY OUT MORE EDIT COMMANDS IF 31. 

YOU LIKE, BUT REMEMBER THIS 

PROGRAM WILL BE ASSEMBLED LATER. 
32. PRESS PF3 32. 
33. PRESS PF3 33. 
34. SELECT FOREGROUND (OPTION 4) 34. 
35. SELECT SYSTEM ASSEMBLER 35. 
36. ENTER ASSEMBLER INPUT: 36. 

PROJECT : SAMPLE 

LIBRARY : USERID 

TYPE 3: ASM 

MEMBER : ASMTEST 

ASSEMBLER 

OPTIONS : LIST TEST RENT 
37. PRESS PF3 37. 
48. PRESS PF3 38. 
39. SELECT BATCH (OPTION 5) 39. 
40. SELECT ASSEMBLER (OPTION 1) AND 40. 


ENTER JOB INFORMATION AS REQUIRED 
BY YOUR INSTALLATION. 


Figure 84. Sample Problem Scenario (Part 
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BROWSE ENTRY PANEL 
SPF PRIMARY OPTION MENU 
EDIT ENTRY PANEL 


EDIT DATA DISPLAY OF 
SAMPLE .USERID.ASM( ASMTEST ) 


CURSOR IS POSITIONED TO THE 
STRING AND SEQUENCE NUMBER 
IS INTENSIFIED. 


THE RIGHT OF LINE IS ERASED 


THE LINE IS REPEATED 


THIS SETS PRINT MODE ON FOR 
AUTOMATIC SOURCE LISTINGS. 


GOOD LUCK 


MEMBER ASMTEST IS SAVED IN 
LIBRARY SAMPLE.USERID.ASM 
AND A LISTING OF THE MEMBER 
IS PLACED IN THE SPF LISTING 
FILE. THE EDIT ENTRY PANEL 
IS DISPLAYED. 


SPF PRIMARY OPTION MENU 
FOREGROUND SELECTION MENU 
FOREGROUND ASSEMBLY PANEL 
ASSEMBLER IS INVCKED. 
TERMINAL OUTPUT IS WRITTEN 
AT THE TOP OF A BLANK 


SCREEN. WHEN "MORE..." 
APPEARS, PRESS PAZ TO 


_ CONTINUE. TEXT FILE IS 


PLACED IN YOUR SPF LIBRARY 
SAMPLE.USERID.TEXT AS 
MEMBER ASNTEST, AND LISTING 
FILE (NAMED ASMTEST) IS 
WRITTEN ON YOUR A-DISK. 
FOREGROUND SELECTION MENU 
SPF PRIMARY OPTION MENU 
BATCH SELECTION MENU 


BATCH ASSEMBLY PANEL 


2 of 3) 
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ACTION RESULT | | 


41. ENTER ASSEMBLER INPUT: 41. CONTROL COMMANDS FOR 

Pe ag? PROJECT 3 SAMPLE — - |... + ASSEMBLING ASMTEST ARE 
LIBRARY : USERID. - GENERATED. THE BATCH 
TYPE : ASM SELECTION MENU IS 
MEMBER =: ASMTEST REDISPLAYED. 
ASSEMBLER 
OPTIONS : TERM 

OBJ NODECK LIST 


42. PRESS PF3 THE JOB IS SUBMITTED TO 
: ; THE CMS BATCH MACHINE. 
WHEN "HOLDING" APPEARS, 
PRESS PA2. PRIMARY OPTION 
MENU IS REDISPLAYED. 


AS THE JOB EXECUTES IN THE BATCH MACHINE, STATUS MESSAGES WILL BE 
RETURNED TO YOU. IN PARTICULAR, YOU WILL RECEIVE A MESSAGE WHEN THE 
ASSEMBLY IS COMPLETE INDICATING THAT THE TEXT AND LISTING FILES HAVE 
‘BEEN SPOOLED TO YOUR READER. DO NOT EXECUTE STEP 44 OF THIS SCENARIO 
UNTIL YOU HAVE RECEIVED THE COMPLETION MESSAGE. 


SELECT TUTORIAL (OPTION T) 43. START OF SPF TUTORIAL IS 
DISPLAYED. FOLLOW THE 
‘DIRECTIONS TO LEARN MORE 
ABOUT SPF. WHEN YOU ARE 
DONE, PRESS PF3 TO RETURN 
TO THE FRIMARY OPTION MENU. 


SELECT READER UTILITY (OPTION 3.7) 44. READER UTILITY PANEL 


SELECT INSERT (OPTION I) AND ENSURE 45. READER UTILITY PANEL IS 
THAT THE TARGET. SPF LIBRARY FOR THE REDISPLAYED, SHCHING 
TEXT FILE IS SAMPLE.USERID. TEXT THAT THE FILE WAS MOVED 
INTO YOUR SPF LIBRARY, 
- AND THAT THE LISTING IS 
NOW THE NEXT FILE IN 
YOUR READER. 


SELECT READ (OPTION R) AND ». READER UTILITY PANEL IS 

RENAME TO : ASMTEST2 LISTING REDISPLAYED, SHOMING 

THEN PRESS ENTER. ' JHAT THE LISTING WAS 
LOADED ONTO YOUR A-DISK, 
AND THAT YOUR READER IS 
NOW EMPTY. 


PRESS PF3 SPF PRIMARY OPTION MENU 


IF YOU HAVE FOLLONED THIS SCENARIO, YOU SHOULD HAVE THO LISTING FILES 
ON YOUR A-DISK, ONE NAMED ASMTEST (FROM THE FOREGROUND ASSEMBLY), AND 
THE OTHER NAMED ASMTEST2 (FROM THE BATCH ASSEMBLY). TRY BROWSE 
(OPTION 1) TO REVIEW THE LISTINGS, AND TRY EXPERIMENTING WITH OTHER 
SPF OPTIONS. WHEN YOU ARE DONE, RETURN TO THE PRIMARY OPTION MENU. 


(AT PRIMARY OPTION MENU) 48. SPF TERMINATION PANEL 
PRESS PF3 , 


SELECT OPTION P FOR BOTH THE LOG 49. THE LOG AND LIST FILES 
AND LIST FILES, AND PRESS ENTER. ARE CLOSED AND RELEASED 
FOR PRINTING. 


YOU ARE NOW OUT OF SPF. TO EXIT 50. END OF SAMPLE 
FROM CNS TYPE "LOGOFF". 





Figure 85. Sample Problem Scenario (Part 3 of 3) 
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APPENDIX B. SPF LISTING FORMATS 


If PRINT mode is on, the SPF editor automatically generates a 
source listing upon completion of editing. Source listings may 
also be obtained via the “print™ option of the SPF library utility 
Coption 3.1) and the move/copy utility Coption 3.3). 


A sample source listing is shown in Figure 86. 


For an SPF library, information at the top of the page includes 
project, library, type, member, current version, and modification 
level. The member name is also repeated at the right for ease of 
filing. For a CMS file, the file id Cand member name for a MACLIB 
or TXTLIB) are indicated. The header lines also include user id, 
date and time that the listing was produced, and page number. 


A column positioning line is printed following the heading and 
preceding the actual data. The "start column" is printed to the 
left of each line, indicating the position of the first non-blank 
character in each line. For SPF library members with statistics, 
asterisks may be printed to the right of each line, as follows: 


° If the modification flag (columns 79-80) in the line is 00, no 
asterisks are printed. 


® If the modification flag is non-zero but differs from the cur- 
rent modification level of the member, a single asterisk (*) 
is printed. 


° If the modification flag is non-zero and has the same value as 
the current modification level of the member, two asterisks 
(**¥) are printed. 


The asterisks allow the listing to be scanned quickly for lines 
that were added or changed since the version was created (*) and 
for lines that were added or changed during the last update (**). 


SPF provides index listings, upon user request, via the “index" 
option of the library utility Coption 3.1). A sample index list- 
ing for an SPF source library is shown in Figure 87. The heading 
information includes: project, library, and type, date and time 
that the listing was produced, and page number. This is followed 
by general information about the library. Following this, the 
member name and statistics are printed for each member, arranged 
in alphabetical order. 


Finally, a sample SPF log listing is shown in Figure 88. The log 
contains a message for each significant user action, such as sav- 
ing edited data, moving members from one library to another, or 
submitting a batch job. 
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OST 


BIUGUBZSy WeuboOuYg WA-4dS$ 


PROJECT: SPFDEMO MEMBER: COINS DATE: 79/05/18 
LIBRARY: MYLIB LEVEL: 01.04 TIME: 17:22 
TYPE: PLI USERID: ORR PAGE: 01 OF 01 


00010001 

PROCEDURE OPTIONS (MAIN); 00020000 
DECLARE 00030000 
COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 00040000 
HALVES FIXED BINARY (31); 00050000 
QUARTERS FIXED BINARY (31), 90069003 
DIMES FIXED BINARY (31), 00070000 
NICKELS FIXED BINARY (31); 00080004 
SYSPRINT FILE STREAM OUTPUT PRINT; 00090000 

DO HALVES = 100 TO 6 BY ~503 90100000 
DO QUARTERS = (100 ~- HALVES) TO 0 BY -253; 00110000 

DO DIMES = ((100 - HALVES ~- QUARTERS)/10)*10 TO 0 BY -10; 00120000 
NICKELS = 100 - HALVES - QUARTERS - DIMES; 00130000 

PUT FILECSYSPRINT) DATAC COUNT, HALVES», QUARTERS,» DIMES, NICKELS ) 300140000 

COUNT = COUNT + 13 00150000 

END; 00160000 

END; 00170000 
END$ 00180000 
END COINS} 00190001 


Figure 86. Sample Source Listing 


* 


HH 





°g XLpuaddy 


szpeuoy 6u13S517] 4dS 


SGT 


PROJECT: SPFDEMO 


LIBRARY: MYLIB 


aI 


TYPE: PLI 

ATTRIBUTE DATA: 
ORGANIZATION: S 
RECORD FORMAT: F 


RECORD LENGTH: 80 


LOCATION DATA: 
OWNER'S ID: 


ORR 


DEVICE ADDR: 193 


MEMBER VERS .MOD 
NAME LEVEL 
ACCOUNT 01.00 
ACCT] 01.01 
ACCT2 01.00 
COINS 01.04 
COMPX 01.60 
COMPY 01.01 
DCLS 01.00 
LISTOUT 01.02 
MAIN 01.00 
TESTDIR 01.02 
-MAXIMUMS : 01.04 
TOTALS: 


END OF MEMBER LIST 


Figure 87. 


CREATION DATE AND TIME 
DATE LAST MODIFIED 
79701709 79/01/09 + =17:07 
79701709 79704723 = 14:52 
79/01/09 79/01/09 «17:07 
79704724 79/04/24 16:20 
79/01/09 79701709 17:08 
79701714 79701714 «12:30 
79/04723 79/04/23 «15:14 
79/04/23 79/04/23 =15:00 
79/01/09 79/01/09 «17:08 
79/04/23 79/05/06 17:04 
79704724 79/05/06 =17:04 


Sample Index Listing - Source Library 


LINK ACCESS 
MODE FOR UPDATE: MW 


CURRENT INITIAL 
NO. LINES - NO. LINES 
21 21 

99 193 

20 20 

19 19 

44 44 

13 13 

20 20 

17 13 

4 4 

30 43 

99 193 

287 390 


DATE: 


ia) 
- 


PAGE: 00 
‘NUMBER OF MEMBERS: 

MODIFIED USER 
NO. LINES ID 

0 KLEIN 

0 KLEIN 

0 ORR 

4 ORR 

0 ORR 

1 ORR 

0 MOSTON 

6 KLEIN 

0 MOSTON 

10 MOSTON 

10 


79/05/08 
TIME: 17:22 


1 


12 











9ST 


Bqusavajay weuhoud WA-dadS 


TIME 


17:11 
17:12 
17:13 
17:13 
17:13 
17:13 
17:13 
17:13 
17:13 
17:13 
17:14 
17:15 
17:15 
17:15 
17:16 
17:17 
17:17 


“47317 


17:19 
17:19 
17:20 


%¥% SPF TRANSACTION LOG x¥* 


START OF SPF 


UTILITY 
UTILITY 


UTILITY 
UTILITY 
UTILITY 


EDIT 
EDIT 
EDIT 
EDIT 
EDIT 
UTILITY 
CMS 
UTILITY 
BATCH 
BATCH 
END OF SPF 


SESSION LOG 15 


SESSION LOG 15 


SPECIFY - 
MOVE/COPY~ 


MOVE/COPY- 
MOVE/COPY- 
MOVE/COPY~ 


SAVE sad 
CREATE = 
SAVE = 
SAVE 
SAVE = 
DELETE - 
COMMAND 
SPECIFY - 
JOBSTEP - 
JOB = 


USERID: JOSLIN 


LIBRARY ‘SPFDEMO.NEWLIB.PLI' CREATED ON JOSLIN 191. 
SPFDENO.MYLIB.PLICACCOUNT) COPIED 

TO SPFDEMO.NEWLIB.PLI( ACCTXX) 
SPFDEMO.MYLIB.PLICACCT1) COPIED 

TO SPFDEMNO.NEWLIB.PLICACCTYY) 
SPFDEMO.MYLIB.PLICACCT2) COPIED 

TO SPFDEMO.NEWLIB.PLICACCTZZ) 
SPFDEMO.MYLIB.PLI(COINS) COPIED 

TO SPFDEMO.NEWLIB.PLI( COINS) 
SPFDEMO.NEWLIB.PLI(COINS) - MEMBER SAVED 
SPFDEMO.NENLIB.PLICACCTNEW) - MEMBER CREATED 
SPFDEMO.NENLIB.PLICACCTXX) - MEMBER SAVED 


- SPFOEMO.NEWLIB.PLICACCTYY) - MEMBER SAVED 


SPFDEMO.NEWLIB.PLICACCTZZ} - MEMBER SAVED 
SPFDEMO.NENLIB.PLICACCTZZ) DELETED 

QR 

LIBRARY 'SPFDEMO.NEWLIB.TEXT’ CREATED ON JOSLIN 191. 
PLI OPT COMPILE -- TO SPFDENO.NEWLIB. TEXT( COINS) 
JOSLIN U101 SUBMITTED. 


Figure 88. Sample Log Listing 


DATE: 79/05/29 
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PAGE: I 


APPENDIX CC. SUMMARY OF SPF COMMANDS 


MEMBER LIST COMMANDS 


The following commands may be entered in the command input field 
Cline 2 of the logical screen) on member list displays. 


LOCATE Causes direct scrolling to the specified member name (may 
be entered on any member list display). 


SELECT Causes the specified member name to be selected for 
browse, edit, or SCRIPT/VS Cinvalid on other utility mem- 
ber list displays). Allows selection of a member which is 
not in the list. 


On member List displays, the following one-character commands may 
be entered at the beginning of a line, ahead of the member name. 


S (select) Causes the member to be selected for browse, edit, 
move/copy, reset, or SCRIPT/VS utility Cinvalid under 
the library utility). 


P Cprint) Causes the member to be printed (valid only under the 
library utility). © 


R Crename) Causes the member to be renamed (valid only under the 
library utility). The new name must be entered to the 
right of the member name. 


D Cdelete) Causes the member to be deleted (valid only under the 
library utility). 


B (browse) Causes the member to be browsed (valid only under the 
library utility). 


BROWSE COMMANDS 


The following commands may be entered in the command input field 
Cline 2 of the logical screen) under browse, and also under 
SCRIPT/VS and the "display" option of the project utility. 


LOCATE Causes direct scrolling to the specified relative line 
number or label. 


-xXxxxx Establishes a label (SPF internal symbol) which is 
equated to the top line on the screen. It can then be 
used with the LOCATE command to cause scrolling directly 
to that line. 


COLS Causes display of a line that identifies column 
positions. ‘ 


RESET Removes the column identification line from display. 

FIND Causes the data to be scanned for one or all occurrences 
of a character string. The cursor is repositioned to the 
beginning of the first occurrence, if it is found. 

CAPS €auses character: strinas, entered as part of the FIND 
command, to be converted to upper case. CAPS OFF causes — 
character strings to be left as-is. 


HEX Causes data to be displayed in hexadecimal format. HEX 
OFF restores normal display format. 
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EDIT LINE COMMANDS 


158 


Under edit, 


line commands may be entered at the beginning of a 


line by overtyping the line number. 


COLS 


I Cinsert) 
D Cdelete) 


R Crepeat) 


M Cmove) 
C Ccopy.) 
A Cafter) 


B (before) 
MASK 

< Cleft) 
> Cright) 
C Cleft) 

» Cright) 
BOUNDS 

X Cexclude) 
S (show) 

F (first) 
L Clast) 
TABS 


TE 
TS 


TF 


0 Coverlay) 


Causes display of a line that identifies column 
positions. 


Causes a new line to be inserted after this line. 
Causes the line to be deleted. 


Causes the line to be repeated and the duplicate copy 
to be inserted after this line. 


Identifies a line to be moved. 
Identifies a line to be copied. 


Identifies the line after which copied or moved lines 
are to be inserted. 


Identifies the line before which copied or moved 
lines are to be inserted. 


Causes display of the insert mask, to allow pre-entry 
of data on inserted lines. 


Causes the contents of the line to be "data" shifted 
left. 


Causes the contents ot the line to be "data" shifted 
right. 


Causes the certents of the line to be "column" 
shifted left. 


Causes the contents of the line to be "column" 
‘shifted right. 


Causes display of the column boundary line, to allow 
redefinition of boundary positions. 


Causes the line to be excluded from display. May also 
be used to limit the scope of the FIND and CHANGE com- 
mands. 


Causes an excluded line to be redisplayed. 


Causes the first line in a block of excluded lines to 
be redisplayed. 


Causes the last line in a block of excluded lines to 
be redisplayed. 


Causes display of the tab line, to allow definition 
of hardware, software, and logical tab positions. 


Facilitates bulk text entry by allowing the user to 
type continuously without regard to the line number 
area. 


Causes splitting of a line into two lines at the 
designated cursor position to facilitate the 
insertion of new material in existing text. 


Causes reflowing of a paragraph of text from  the- 
cursor position to the end of the paragraph. 


Causes data to be copied or moved “over" the existing 
data on one or more lines. Blank characters in the 
receiving line(€s) are overlayed with corresponding 
characters in the source line(s). 
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The following line commands may be entered with double characters 
to indicate the beginning and end of a block of lines. 


~- Block delete << =- Block "data”™ shift left 
Block repeat >> Block "data™ shift right 


- Block move CC =- Block "column" shift left 
- Block copy >> - Block "column" shift right 
~ Block exclude 00 = Block overlay 


The following. line commands. may incorporate a number (n) consist- 
ing of one or more digits. 


In - Insert n lines following this line 
Dn - Delete n lines starting at this line 
Rn - Repeat this line n times 
RRn ~ Repeat block of lines n times 
Mn - Move n lines starting at this line 
Cn - Copy n lines starting at this line 
An - Insert n copies of the moved/copied line(s) 
after this line 
Bn =- Insert n copies of the moved/copied line(s) 
‘before this line 
<n - Data-shift line left n positions 
<<n - Data-shift block of lines left n positions 
>n - Data-shift line right n positions 
>>n - Data-shift block of lines right n positions 
(n ~- Column-shift line left n positions 
(Cn - Column-shift block of lines left n positions 
In - Column-shift line right n positions 
In ~— Column-shift block of lines right n positions 
Xn - Exclude n lines starting at this line 
Sn -~- Show n lines in a block of excluded lines 
Fn .-~ Show first n lines in a block of excluded lines 
Ln =- Show last n lines in a bleck of excluded lines 
TEn - Insert n text entry Lines following this line 
TSn - Insert n new lines between the split lines 
TFn ~- Flow text from left bound to column position n 
b On - Overlay'n lines 
v If a number is not entered, the default is 1 except for: 
e The shift commands (which default to 2 column positions) 
° The TE command (defaults to the number of lines remaining on 
the screen) 
° The TF command (defaults to the specified column boundaries) 


EDIT PRIMARY COMMANDS 


Under edit, the following commands may be entered in the command 
input field (Cline 2 of the logical screen). 


LOCATE 
NUMBER 


RENUM 
UNNUM 


AUTONUM 


STATS 


Causes direct scrolling to the specified line number. 


Causes sequence numbers to be generated for any new 
lines that are created via insert, repeat, or copy. NUM- 
BER OFF causes lines to be generated without numbers. 


Renumbers each line and turns on NUMBER mode. 


Causes sequence numbers to be set to blanks and turns off 
NUMBER mode. 


If edit is in NUMBER mode, causes sequence numbers to be 
automatically renumbered whenever a save is’ done. 
AUTONUM OFF bypasses automatic renumbering at save time. 


Causes SPF statistics to be generated or updated 


whenever a member 1s saved, created, or replaced. STATS 
OFF causes members to be stored without statistics. 
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PRINT 


RECOVERY 


RESET 
SUBMIT 
SAVE 


CANCEL 
FIND 


CHANGE 


COPY 


MOVE 


CREATE 


REPLACE 


NULLS 


TABS 


PROFILE 


HEX 


CAPS 


Causes a source listing of the edited data to be 
automatically recorded in the SPF list file whenever 
edit is terminated by pressing the End PF key. PRINT OFF 
bypasses automatic source Listings. 


Enables the SPF edit recovery function. If there is a 
subsequent system failure, the user can recover the SPF 
edit session up to the point of failure. RECOVERY OFF 
disables the edit recovery function. 


Causes a general resetting of intensified messages, 
incomplete line commands, and special lines. 


Causes the data being edited to be punched to another 
virtual machine for batch execution. 


Causes the data to be stored back into the edit file and 
editing to continue. 


Causes editing to be terminated without saving the data. 


- Causes the data to be scanned for one or all occurrences 


of a character string. The cursor is repositioned to the 
beginning of the first occurrence, if it is found. 


Causes one or all occurrences of a character string to be 


replaced with a second string. The cursor is reposi~ 
tioned to the end of the first occurrence, if it is 
found. 


Causes data to be copied from another source and 
inserted at a point indicated with the A Cafter) or B 
(before) line command. The other source can be a member 
of an SPF library or MACLIB, or a sequential CMS file. | 


Same as COPY, except that the other source is deleted 
after the copy operation. 


Caaes a line or block of lines to be stored in any SPF 
library or MACLIB as a new member. The line €s) to ba 
stored are designated with the C or CC Ccopy), or M or MM 
(move) line commands. 


Same as CREATE, except that it allows an existing member 
or a sequential CMS file to be replaced. 


Replaces trailing blanks on the = screen with null 
characters. NULL OFF causes trailing blanks to be sent 
to the screen as blanks. 


Enables the use of “hardware” or "logical" tabs at user 
defined positions (specified via the tabs line command). 
TABS OFF disables the use of "hardware" or "logical" 


Causes the display of the current setting of edit modes 
CNUMBER, AUTONUM, STATS, PRINT, CAPS, NULLS, TABS, HEX, 
and RECOVERY). Also displays the MASK, TABS, and BOUNDS 
lines whenever they have. settings other than their 
defaults. . 


Causes data to be displayed in hexadecimal format. HEX 
OFF restores normal display format 


Causes alphabetic data entered from the terminal to be 
translated to upper case, including FIND and CHANGE 
strings. CAPS OFF causes alphabetic data to be left 
as-is. : : 
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APPENDIX D. SPF COMMAND SYNTAX - QUICK REFERENCE SUMMARY 


MEMBER LIST COMMANDS 


Primary Commands: 


LOCATE member-name 
SELECT member-name 
BROWSE COMMANDS 
LOCATG 3 line-number/iabel 
XXXXX 
COLS 
RESET 
FIND string 
[col-1 [col-2]] 
CAPS [ON/OFF] 
HEX [ON/OFF] LVERT/DATA] 
EDIT LINE COMMANDS 
Basic Commands: 
COLS 
I, In Cinsert) 
D> Dn> DD (delete) 
R, Rn», RR, RRn Crepeat) 
M, Mn, MM (move) 
Cy. Crs CC Ccopy) 
A, An Cafter) 
B, Bn (before) 


Text Preparation Features: 


TE, TEn 
TS, TSn 
TF, TFn 
0, On, 


Append 


WOAUD 


(select) - 


Cprint) 

Crename) 
(delete) 
Cbrowse) 


CNEXT/ALL/FIRST/LAST/PREV] 


[CHARS/PREFIX/SUFFIX/WORD] 


(text entry) 

{text split) 

(text flow) 
00 Coverlay) 


ix D. 


MASK 

<>, <thp <<, 
>» Pi, 27>, 
C, Cn, CC, 
», In, 3), 
BOUNDS 

X» Xn» XX 
S, Sn 

F, Fn 

L, Ln 

TABS 


Line Selection Commands: 


except opt. 


option 3.1 
option 3.1 
option 3.1 
option 3.1 


Advanced Features: 


<<n Cdata 
>>n Cdata 
(Cn Ccols 
Wn Cools 


Cexclude) 
(show) 
(first) 
Clast) 


SPF Command Syntax - Quick Reference Summary 


5 re | 


only 
only 
only 
only 


left) 
right) 
left) 
right) 


EDIT PRIMARY COMMANDS © 


General Commands: 
LOCATE 
NUMBER 


‘line-number 


CON/OFF] 
CSTD] CCOBOL] [DISPLAY] 


RENUM [STD] [COBOL] [DISPLAY] 
UNNUM | 

AUTONUM [ON/OFF] 

STATS [ON/OFF] 
-PRINT (CON/OFF] 

RECOVERY [ON/OFF] 

RESET 

SUBMIT machine-id 

SAVE 

CANCEL 


Find and Change Commands: 


Advanced Features: 
COPY 
MOVE * [member-name] 
CREATE 
REPLACE 
NULLS 

TABS 


[member-name] 


[member-name] 

[member-name] 
[ON/OFF] CALL] 
poo ai CALL] 
PROFILE 


HEX 


C[name] [number] 


[ON/OFF] 
[VERT/DATA] 





Text Preparation Features: 
CAPS [ON/OFF] 


CNEXT/ALL/FIRST/LAST/PREV] 


[ CHARS/PREFIX/SUFFIX/WORD] 


FIND string-1 

[X/NX] 

Ccol-1 [col-2]] 
CHANGE string-1  string-2 





[NEXT/ALL/FIRST/LAST/PREV] 


[CHARS/PREFIX/SUFFIX/WORD] 





[X/NX] 
[col-1 [col-2]] 


FIND/CHANGE STRINGS (BROWSE AND EDIT) 
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Character String Format: 


(no embedded blanks or commas) 


Simple string: ecccce 

Delimited string: *eecec’ ‘or: “eccec™ 

Hex string: X*'hhhh! or "hhhh'X 

Text string: T'ccec’ or ‘eccc'T 
Picture string: P*'ssss' or 'ssss'P | 
Previous string: _ ¥ Csingle asterisk) 


Picture Strings - Special Characters: 


P'=*' .- any 
piat = any 

;: - any 
ap - any 
pa cue 
P'¥<' = any 
P'>' = any 
P'*$' -- any 


character (don't care) 
non-blank character 


non-displayable Cinvalid) character 


numeric character (0-9) 
non-numeric character 


alphabetic character Cupper | or lower case) 


lower case alphabetic character 
upper case alphabetic character 
special character (not alpha or 
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APPENDIX E. SPF-MVS AND SPF-~VM DIFFERENCES 


The System Productivity Facility (SPF) supports two environments: 


° MVS Time Sharing Option (SPF-MVS) 
° VM/SP Conversational Monitor System (SPF-VM) 


Following is a summary of differences between the two environ- 
ments pertaining to the SPF program development facility. 


° On the primary option menu, option 6 is: 


SPF-MVS: Enter TSO Command or CLIST 
SPF-VM : Enter CMS Command or EXEC 


° Panels and tutorials which refer to "data sets" in SPF-MVS 
refer to "files" in SPF-VM. The first part of an entry panel 
(browse or edit, for example) allows specification of an SPF 
library. The format is identical in SPF-MVS and SPF-VM: 


SPF LIBRARY: 






PROJECT ===> 
LIBRARY ===> 
TYPE ===> 
MEMBER ===> (BLANK FOR MEMBER SELECTION LIST) 
° The second part of an entry panel differs as follows. For 
SPF-MVS: 


DATASET NAME ===> 
VOLUME SERIAL ===> - . CIF NOT CATALOGED) 


OTHER PARTITIONED 0 


R SEQUENTIAL DATASET: 





For SPF-VM: 


CMS FILE: 
FILE ID 
MEMBER (FOR MACLIB OR TXTLIB} 
IF NOT L 






OWNER'S DEVICE ADDR. ===> LINK ACCESS MODE ===> 


° The third part of an entry panel contains an (0S) password 
field for SPF-MVS. For SPF-VM, this part of the panel may 
contain a read passwerd field, an update password field, or 
both, depending on the type of function. In SPF-MVS, pass- 
Pia pertain to data sets; in SPF-VM, they pertain to mini-~ 

isks. 


7) Implementation of SPF libraries is accomplished in SPF-MVS 


using partitioned data sets, while SPF-VM uses sequential CMS 
files and/or MACLIBs and TXTLIBs Cunder user option). 


° SPF-MVS supports printing on either: 


System printer (via submission of a background job) 
328x printer C€via interface to DSPRINT command) 


SPF-VM supports printing via the CMS PRINT command. The out- 
put may be directed to the system printer or spooled to anoth- 
er user (Cor machine), which may be at a remote node in the 
network. oe ae 


° Specification of "job ‘statement information” .o¢ecurs in 
SPF-MVS on the background selection menu and all panels per- 
taining to hardcopy output. SPF-VM provides. job information 
on the batch selection menu only. All other output is accom- 
plished with the CMS PRINT, PUNCH, or DISK DUMP commands, 
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rather than via job submission. _ 


Additionally, job statement information syntax and keywords 
are different, reflecting differences between CMS batch job 
streams and VS2 JCL. 


Differences in foreground processing (Coption 4) and back- 
ground (batch) processing Coption 5) are as follows: 


SPF-MVS: Compiled/assembled output Cobject module) goes into 
‘an SPF library whose "type”™ is OBJ. Link edit out- 
put Cload module) goes into an SPF library whose 
"type" is LOAD. 


SPF-VM: Compiled/assembled output Cobject module) goes into 
an SPF library whose "type” is TEXT. Linkage edit- 
ing is not supported, but the LOAD command is sup- 

ported. 


Option 3.2 (dataset/file utility). The following suboptions 
of this utility in SPF-MVS: 


A - Allocate new data set 
C ~ Catalog data sat 
U- Uncatalog data set 


are replaced in SPF-VM with: 


SS Speci fy new SPF library 
U - Unspecify SPF library 


There is no need for an "allocate file” capability under 
SPF-VM, since space allocation is handled automatically by 
VMN/ZCMS. There is, however, a need to pre-specify SPF library 
identifiers and file characteristics to SPF-VM. 


Option 3.4. In SPF-MVS this is the catalog management utili- 
ty. In SPF-VM it is replaced with the project utility, which 
provides a similar function for SPF libraries. 


Option 3.6. In SPF-MVS this is the hardcopy utility. In 
SPF-VM it is replaced with the spool utility, which provides 
similar functions for printing and punching, and also allows 
spooling to another user (Cor machine), which may be at a 
remote node in the network. 


Option 3.7. In SPF-MVS this is the list VTOC utility, which 
has no equivalent in SPF-VM. It is replaced in SPF~-VM with 
the reader utility. . 


Option 3.8. In SPF-MVS this is the outlist utility, which has 
no equivalent in SPF-VM. It is replaced in SPF-VM with the 
retrieve utility. 
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APPENDIX F. SPF LIBRARY SPECIFICATION AND USAGE 


Before reading this appendix, please review the section entitled 
"SPF Libraries" in the general description section of this docu- 
ment. 


GUIDELINES FOR LIBRARY SPECIFICATION 


Each SPF library must be specified via the SPF file utility 
Coption 3.2) before it can be used. The name of the library along 
with the following information must be specified: 


SPF library attributes: 
Organization (S = set of files, M = MACLIB, T = TXTLIB) 
Record format CF = fixed, V = variable) 
Record lanath (1 ton 32767 bvtes) 


SPF library location: 
Owner's id (blank for your user id) 
Device addr. Cblank for '191') 


Link access mode for update: 
Mode letters CM, W, or MWD 


For organization S (set of files): 


Filetype (blank for SPF-generated name) 
For organization M or T CMACLIB or TXTLIB): 


Filename (blank for SPF-generated name) 


Naming Conventions 


An SPF library is always identified by a 3-component name Cproject 
name, library name, and type), where: 


° "project name" is the common identifier for all libraries 
belonging to the same programming project. 


° "library name" jidentifies the particular set of libraries 
Ci.e., the level within the library hierarchy). For a private 
library, the user id is an appropriate library name. 


° "type" identifies the type of information in the library. The 
SPF type qualifier need not conform to the standard CMS naming 
conventions, with one exception: If the library is to contain 
TEXT Cobject) modules, the SPF type qualifier must be TEXT 
regardless of whether the library organization is "S" (set of 
sequential files) or "T™ CTXTLIB). 


Each component of the name may be up to eight alphameric charac” 
ters, of which the first must be alphabetic. The same rule 
applies to member names. 


Library Organization 


The library organization must be one of the following: 


S$ - The library will be maintained as a set of CMS sequential 
files, all with the same filetype. The CMS filenames will be 
the same as the SPF member names, and the CMS filetype may be 
anything which uniquely identifies the set of files on the 
minidisk. 
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M - The library will be maintained as a CMS file with a filetype 
of MACLIB. The CMS filename may be anything which uniquely 
identifies the MACLIB on the minidisk. The member names in 
the MACLIB. will be the same as the SPF member names. 


T - The library will be maintained as a cms file Heth a filetype 
of TXTLIB. The CMS filename may be anything which uniquely 
identifies the TXTLIB on the minidisk. The member names in 
the TXTLIB will be the same as the SPF member names. 


Libraries containing documentation to be processed by the 
SCRIPT/VS utility Coption 3.9) must have an organization of *S", 
but they need not have an SPF type qualifier of SCRIPT nor a CMS 
filetype of SCRIPT. 


Libraries containing TEXT (object) modules must have an organiza~ 
* tion of "S™ or "T", and the SPF type qualifier must be TEXT. (For 
organization "S" the CMS filetype need not be TEXT.) 


s Any other libraries may have an organization of "S”" or "M". There 
are no restrictions on the SPF type qualifier, nor the CMS 
filetype (for organization "5"), 


Following are additional suggestions for specifying library 
organization: 


° Libraries which are frequently updated Cespecially the lowest 
level libraries in a project hierarchy) should be assigned an 


organization of "5". This will eliminate the need for com- 
presses. 
° As a performance consideration, it may be desirable to assign 


higher level libraries an organization of "M" or "T" if one or 
more of the folloning applies: 


- The Library has many members. 
7 The library is infrequently updated. 


= The library contains members which are included or copied 
by other members during a compile or assembly. See "Fore- 
ground/Batch Processing", which follows, for a discussion 
of included members. 


Record Format and Length 


Libraries which have an organization of "M" or "T"™ must have a 
record format of "F" (fixed), and a record length of 80. 
Libraries which have an organization of "S" may have a record for- 
mat of either "F" or "V" (variable), and a record length from 1 to 
32767. Note, however, that the SPF editor widd not process any 
data with a record length less than 10. | 


For format "F"™, the pSeond Vength ea ycakes.! the exact length of 

each record in the library. For format "V", the record length 

lel the maximum allowable length of any record in the 
ibrary. 


Library Location 


Each SPF library must be wholly contained on one minidisk, which 
is specified via owner's user id and virtual device address. 


More than one SPF library may be assigned to the same minidisk, 
and SPF libraries may co-reside on the same minidisk with other 
CMS files (which are not SPF libraries). Be careful, however, to 
guard against conflicting CMS filetypes or filenames (see "Unique 
Identifier” and "Foreground/Batch Processing” which follow). 
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Following are additional suggestions for specifying library 
location: 


e Typically, the lowest level libraries in a project hierarchy 
are private libraries and should reside on a minidisk which is 
owned by the user of the library Cand should have an organiza- 
tion of "S™). 


° Higher level libraries in the project hierarchy are typically 
common libraries which are accessed for reading by anyone on 
the project, but are controlled Cupdated) by one designated 
individual. It is a good idea for these libraries to be on 
minidisks which are owned by the person who will be updating 
them, and which are write protected Ci.e., no update password 
or an update password known only to the owner). 


° If higher level libraries are to be protected against unau- 
thorized reading by anyone outside the project, they should 
reside on minidisks which all have the same read password. 
The reason for this is that SPF panels provide a single read 
password which applies to all libraries in the concatenation 
sequence. 


Link Access Mode 


The link access mode for update must be one of the following: 


W - Link will be successful only if no other user is currently 
accessing the minidisk Cin either read or write mode). 


M - Link will be successful if no other user is currently 
accessing the minidisk in write mode. 


MW - Link will be successful in all cases. 


If the library is to reside on a user's A-disk (which SPF assumes 
has a virtual device address of 191), do not specify "MN" for the 
link access mode. SPF will not protect against multiple write 
accessing to virtual device 191. 


Note: As a general rule, multiple-write passwords should not be 
assigned to a user's A-disk. The absence of a such a password 
will prevent any attempt to Link to the disk in "MW" mode. 


For SPF libraries which are not on a user's A-disk, a link access 
mode of "MH" may be specified provided that all access to that 
minidisk (for SPF libraries or any other files) is through SPF. 
If some accesses to the minidisk will be done outside SPF, a link 
access mode of "M™ or "W" should be specified. 


SPF provides appropriate protection to guard against destructive 
contention in multiple read/write accessing of SPF libraries and 
CMS files, except as noted above for a user's A-disk. 


Unique Identifier 


The CMS filetype (for organization "S") or CMS filename (for 
organization "M" or "T™) must uniquely identify which files on a 
minidisk belong to the SPF library. The recommended procedure is 
to let SPF assign a unique identifier by leaving the filetype and 
filename fields blank on the "specify" panel. The SPF-assigned 
identifier will be of the form: 


SPFnnnnc 


where "nnnn" is a four digit number, and "c" is S, M, or T. 
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Keep in mind the following points: 


e For an SPF library, the CMS eietyow bokeanieat ven "SY") or 


filename Corganization "M" or "T"™) need not conform to any CMS 
naming convention. 


© Since the SPF ibpeny can be referenced By project, library, 
and type on any panel, the CMS filetype or filename is gener- 
ally transparent to the user. 


If a filetype or filename is entered on the "specify”" panel, it is 
the user’s responsibility to ensure that the identifier is unique 
for the minidisk. If sequential files already exist on the mini- 
disk with the specified filetype, or if MACLIBs or TXTLIBs already 
exist on the minidisk with the specified filename, the existing 
files will automatically be included in the SPF library. This may 
or may not be desired. In any case, the SPF file utility will 
display a warning on the "confirm specify" panel that existing 


files will be included in the SPF library. 


PROCESSING CONSIDERATIONS 


SPF maintains information on all SPF libraries specified to the VM 
system. Whenever a user enters project, library, and type ona 
panel, SPF determines the minidisk on which the library is located 
Cuser id and virtual device address), and then performs the neces- 


sary LINK and ACCESS commands on behalf of the user. 


For the LINK command, SPF uses a link access mode of "RR" (for a 
read-only function such as browse), or whatever mode was entered 
when the library was specified (for an update function such as 
edit). Link access mode "RR" allows the LINK to occur even if 
another user has the disk accessed in read or write status. 


For the ACCESS command, SPF selects the first available mode let- 
ter Cin the collating sequence) which is not currently in use by 
the user who is accessing the library. 


The minidisk containing the SPF library is automatically detached 
Cand the mode letter is released) when the user finishes the 
selected SPF function. 


Under certain circumstances, the automatic LINK and ACCESS can 
cause a temporary alteration to the user's normal search sequence 
for CMS files. Example: 


Suppose the user has explicitly accessed two minidisks, using 
mode letters A and C. Subsequently, the user specifies an SPF 
library on some panel (such as browse). SPF selects mode let~ 
ter B to access the library. The user then enters” split 
screen mode (without leaving browse), and specifies a CMS 
filename and filetype on another panel. If the specified file 
exists on both the B and C disks (but not on A), the B copy 
will be found first. The user may not be expecting this, 
since he did not explicitly access the B-disk. 


Foreground/Batch Processing 
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The SPF foreground and batch processing options Coptions 4 and 5) 
automatically perform the following operations if an SPF library 
Cor concatenated sequence of libraries) is specified: 


° The library Cor sequence of libraries) is scanned to find the 
specified member, and the member is copied to a temporary 
file, if required, with a CMS filetype which is acceptable to 
the particular processing program (e.g., ASSEMBLE, COBOL, 
PLI}. The CNS filename for the temporary file will be the 
same as the SPF member name. 
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° For any libraries in the SPF concatenation sequence Cinclud- 
ing the first, or only, library) which are not organization 
"mM", temporary MACLIBs are created and all members are copied 
from each SPF library to the corresponding MACLIB. A GLOBAL 
command is then executed to set up the MACLIB concatenation 
sequence. This allows members to be included (via INCLUDE or 
COPY statements) from the concatenated sequence of libraries 
during the compilation or assembly. 


° For foreground processing, the temporary file and temporary 
MACLIBs will reside on the the user's A-disk. For batch, they 
Will reside on the batch machine's A-disk. In either case, 
the temporary files are erased once the compilation or assem- 
bly has completed. 


° The TEXT Cobject) module produced by the compilation or 
' assembly is placed in an SPF library with the following name: 


Project - same as project name of source library 
Library - same as first Library in concatenation sequence 
Type - TEXT 


For foreground processing, the TEXT module is automatically 
placed in the SPF TEXT library. For batch processing, the 
user may invoke the SPF reader utility Coption 3.7) to cause 
the TEXT module to be inserted into the SPF TEXT library. 


SPF Library Statistics 


Whenever an SPF library is specified, a separate file is created 
on the same minidisk to contain the library statistics. This isa 
sequential file with a CMS filetype of SPFSTATS and a filename 
which is the same as the unique identifier of the SPF library. 


Generally, the SPFSTATS file is transparent to the user, since the 
statistics are automatically created and maintained by the SPF 
editor Cif STATS mode is on), and automatically displayed on mem- 
ber selection lists and printed on "index" listings. 


Users should not attempt to edit or otherwise modify the SPFSTATS 
files. If an SPFSTATS file is modified or destroyed, however, only 
the statistics will be lost; the contents of the SPF library mem~ 
bers will still be intact. 


If members of the SPF library are modified outside of SPF (via 
some other editor) or are specified on an SPF panel via CMS file 
id Crather than project, library, and type), the statistics will 


-not be properly updated, but the information in the member will 


still be acceptable to SPF. 


Note: If a user deletes all lines in a member of an SPF library 
Cusing. the SPF editor) and then saves the member, the statistics 
will show that the member still exists but has a length of zero. 
However, if the library is specified for a foreground or batch 
compilation or assembly, the member will not be found by the proc” 
essing program. The proper way to delete a member Cincluding its 
statistics) is to use the library utility Coption 3.1). 
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Access (see Link Access Mode) 
After "A" Line Command 52 
Attention PA Key 10 © 
AUTONUM Command 58 

Autonum Mode 43 


Batch Calso, see Job) 

Batch Processing 133, 168 

Insert Batch Output in SPF Library .118 
Before "B" Line Command 52 
BOUNDS Line Command 74 
Browse 28 
Browse Member 102 
Browse Member "B" Command 21, 102 


CANCEL Command 60 
CAPS Command (Browse) 36 
CAPS Command CEdit) 91 
Caps Mode CEdit) 43 
Caution Message CEdit) 44 
Change 
CHANGE Command 62, 65 
Repeat Change PF Key 11, 63 
CMS Command Entry 137. 
CMS File Id 8, 104, 167 


COOLS Command (Browse) 31 


COLS Line Command CEdit) 47 

Command Entry 137 

Compress MACLIB 101 

Console 16, 19, 25 

Concatenation of SPF Libraries 6, 8, 38, 129, 133, 168 
Convert 


Menus 143 
Messages 145 
Copy 


Copy File or Member (Move/Copy Utility) 107 
COPY Command 9 . 
Copy "C™ Line Command 52 
CREATE Command 82 
Create/Update SPF Statistics 113 
Cursor 
Cursor Positioning in Edit 54 
Move Cursor PF Key 


Data Display Format 3 
Delete 
Delete "D" Line Command 48 
Delete Member 102 
Delete Member "D"™ Command 21, 102 
Delete Reader File 118 
Delete SPF Library or File 105 
Delete SPF Statistics 113 
Display ne 1G 
Display Document (SCRIPT/VS) 124 
Display Member Selection List 8, 20, 102 
Display Project Entries Il1l 
Display SPF Library or File Information 105 
SPF Display Formats 
Down Scroll PF Key 11, 12 
Draft Document Options (SCRIPT/VS) 125 


Edit 38 

Edit Modes and Profiles 43 

End PF Key 11 

Exclude "X"* Line Command 76 
Calso, see Show Excluded Lines) 

EXEC Processing 137 
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File - CMS File Id 8, 104, 167 
File Utility 104 
Final Document Options (SCRIPT/VS) 126 
Find 
FIND Command (Browse) 32, 33 
FIND Command CEdit) 62, 65 
Repeat Find PF Key (Browse) 11, 32 
Repeat Find PF Key CEdit) 11, 63 
First "F"™ Line Command 76 
Foreground Processing 129, 168 


Help 
Help PF Key 11 a oe 
Help Information 14 
HEX Command (Browse) 36 
HEX Command CEdit) 893 
Hex Mode CEdit) 43 
Hex String 33, 65 


Indentation 71 
(also, see Shift Line) 
Insert "I" Line Command 48 
Insert Batch Output in SPF Library 118 
Invocation of SPF 17 
ISPF Command 17 


Job ; 
Job Submission for CMS Batch Processing 133 
Job Submission from Edit 60 
Job Submission from Spool Utility 115 


Label (Browse) 30 
Language Processors 18, 129, 133 
Last "L"™ Line Command 76 
Left Scroll PF Key 11, 12 
Libraries 
Library Name 6, 165 
Library Statistics 15, 113, 169 
SPF Library Organization 6, 104, 121, 165 
Library Utility 101 ; 
Line Number 30, 55 
Link Access Mode 8, 104, 167 
List File 16, 19, 25 
Listing Formats) 153 
LOCATE Command (Browse) 30 
LOCATE Command (Edit) 55 
LOCATE Command (Member Lists) 20 
Log File 16, 19, 25, 156 
Logical Screen 13 


MASK Line Command 69 
Member Selection List 3, 8, 20 


Menus 3, 8 
Minidisk 8, 9, 166 
Move 


Move Cursor PF Key 11 
Move File or Member (Move/Copy Utility) 107 
MOVE Command 890 

Move "MM" Line Command 52 


NULLS Command 384 
Nulls Mode 43 
NUMBER Command 57 
Number Mode 43 


Overlay "0" Line Command 98 


Page Size 
For Listings 25 
For Scrolling 12 
Passwords 9, 167 
Picture String 33, 35, 65, 68 
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Printing 
Automatic Printing of Edited Data 43, 58 
Listing Formats 153 i 
PRINT Command 58 
Print Document (SCRIPT/VS) 128 
Print Index Listing 101, 153 
Print Listing File 115 
Print Member 102, 153 
Print Member "P"™ Command 21, .102 
Print Mode 43 
Print Option of Move/Copy 107 
Print Screen PF Key ll 
Print Project Entries 111 
Print SPF Library or File 102, 153 
Process 
Batch Processing 133, 168 
Foreground Processing 129, 168 
Language Processors 18, 129, 133. 
SCRIPT/VS Document Processing i124 
Profile 
Edit Profiles 43 
PROFILE Command 87 
User Profiles 9 
Program Access (PA) Keys 19 
Program Function (PF) Keys 10, 26 
Programming Libraries 6, 165 
Project Name 6, 165 
Project Utility 111 
Protection (see Passwords) 
Punch 
Punch File with Header 115 
Punch Job (no Header) 115 
Punched Output from Batch Processing 118, 134 


Read File from Virtual Reader 118 
Reader Utility 118 
RECOVERY Command 59 
Recovery Mode 43 
Rename 
Rename SPF Library or File 105 
Rename Member 102 
Rename Member "R®™ Command 21, 102 
RENUM Command 57 
Repeat 
Repeat Change PF Key 11, 63 
Repeat Find PF Key 11, 32, 63 
Repeat "R" Line Command 50 
REPLACE Command 8&2 
RESET Command (Browse) 31 
RESET Command CEdit) 60 
Reset SPF Statistics Utility 113 
Reshow PA Key 10 
Retrieve Utility 121 
Return PF Key 11 
Right Scroll PF Key 11, 12 


SAVE Command 60 

Screen Format (3278 Model 5) 23 

Screen Window 12 

SCRIPT/VS Utility 124 

Scroll PF Keys 11, 12 

Security (see Passwords) 

SELECT Command (Member Lists) 21 

Select Member "S" Command = 21 

Sequence Numbering CEdit) 55 

Shift Line et 
Shift Columns Left "C™" Line Command 71 
Shift Columns Right ")" Line Command 71 
Shift Data Left "<" Line Command 71 
Shift Data Right ">" Line Command 71 

Show Excluded Lines 
Show "S$" Line Command 76 
Show First "F"™ Line Command 76 
Show Last "L™ Line Command 76 

Specify New SPF Library 104, 165 
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SPF Parms Option 22 
Split Screen 13 
Split PF Key 11, 13 
Swap PF Key 11, 13 
Spool Utility 115 
Statistics, Library 15, 113, 169 
STATS Command 58 
Stats Mode 43 
Store SPF Library from Virtual Reader 119 
Structured Programming 2 
Submit Batch Job Csee Job) 
SUBMIT Command 
Support Option 139 
Swap PF Key 11, 13 


TABS Command 86 
TABS Line Command 85 
Tabs Mode 43 
Terminal Characteristics 23 
Termination of SPF 18 
Test 

Function 141 

Menu 145 

Panel 149 

Variables 142 
Text Entry "TE™ Line Command 92 
Text Flow "TF" Line Command 96 
Text Preparation Features 91 
Text Split "TS" Line Command 92 
Text String 33, 35, 65, 67 
Transmit SPF Library or File 115 
TSO - Retrieve SPF/TSO Libraries 121 
Tutorial 147 
Type Qualifier 6, 165 


UNNUM Command 57 
Unspecify SPF Library 105 
Up Scroll PF Key 11, 12 
Update SPF Statistics 113 
User Profiles 9 
Utilities 

File 104 

Library 101 

Move/Copy 107 

Project 111 

Reader 118 

Reset 113 

Retrieve 121] 

SCRIPT/VS 124 

Spool 115 


"X" Line Command (see Excluded Lines) 76 


Index 
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